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ライブラリリファレンスについて 


A . ライブラリリファレンスについて 


Vol . 2では，ライブラリに含まれる各関数の リファレンスマニュアルを 掲載 
します。 マニュアルは おおむね次のような形式で記述されていますので，よく読 
んでからお使いください。なお，非常に関連の深い関数同士は，まとめて1つの 
ページに記述されている場合があります。 

用 途——関数の用途について簡単にまとめて記述してあります。何に使う 

かを知るためには最も有効な項目です。 

書 式一関数を使用するために必要なインクルードファイルと関数のプロ 

トタイプについて記述してあります。目的の関数を使用したい場 
合には，必ずここに指定されたインクルードファイルを読み込む 
ようにしなければなりません。 

解 説——関数の引数の意味や関数の用法，細部の仕様などについて記述 

してあります。関数を使用する前によく読んでおいてください。 

はとは動作が異なるものも多く，またいろいろな拡張 
がほどこされていますから，従来の発想で利用すると正しく動作 
しない場合があります。 

戻り値——もし関数に戻り値があるならば，それについて記述してありま 
す。また関数がエラーを返すならば，そのことについても触れて 
います。 

注 意一関数を使用する際に気をつけなければならないことがらや制限事 

項について記述してあります。ここに書いてあることは必ず守ら 
なければなりません。注意してください。 

互換性—— ZC や MS - C 7.0 などの他のコンパイラのライブラリとの互換性 
について，互換性が「ない」場合にはそれに関して記述してあり 
ます。これ以外にも細部で異なっている場合はありますが，それ 
らはおおむね上位コンハ。チブルと考えていただいて結構です。た 
だし，この欄に記述があるものは互換性がないものと思ってくだ 
さい。 

規 格——関数を作成するにあたって参照した各種の規格，コンハ。イラなど 

の名称について記述してあります。関数の他の処理系への移 t 直性 
を示していると考えてください。ただし，仕様などが一部異なる 
場合もあるので，目安程度に考えてください。 
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ライブラリー第 2 部 


関連項目一当該関数に関連する他の関数について記述してあります。当該関 
数の説明だけでは不十分な場合には，これらの関連する項目につ 
いても調べてみてください。 

変 更——従来の関数仕様 （ U 5 C Ver .1.0.20) と 「 X 6 S 0 xO Develop . Sz libc 

IIj の関数仕様 （ZJBC Ver .1.1.31) の違いについてまとめてあり 
ます。とくに変更がない場合は，記述してありません。その場合 
はおおむね互換であると考えてください。 

なお，マニュアル中では引数をイタリック体 （/ 如// c ) で，それ以外の関数名や 
変数名などをタイプフエース体 ( typeface ) というようにフォントを変えて示し 
てあります。ただし，書式内での引数はタイプフヱース体で示しています。 
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Chapter 1 


c 標準関数ライブラリ 


本章には C の標準関数ライブラリのマニュアルを掲載します。 LIBC で 
は， AiVSJC で規定された標準関数に加え，低水準 I / O コント 
ロール，プロセス管理やユーザ管理など，必須の関数群をサポートして 
あります。 

なかには UNIX の機能をエミュレートするための関数も少なくありま 
せん。必ずしも初心者にとっては扱いやすい関数ばかりではありません 
が，よくマニュアルを読んで使用してください0 



























































































































































































































































ライブラリー第 2 部 


—addlastsep 


用 途ーパス名の最後にパス区切り記号を付加する。 

書 式' # include く sys/xglob.h 〉 

char *_addlastsep (char *path); 

解 説 —— .addlastsep 関数は，焊认で指定されたパス名の最後にパス区切り記号を付加す 
る。ただし，すでに区切り記号が存在する場合は何も行わない。 

戻り値一 path を返す。 

注 意—— ZJ 併7ではパス区切り記号は“/”と“の両方を認識するが，結果はすべてスラッ 

シュ“/”になるように変換される。 _addlastsep 関数はライブラリの内部関数な 
ので，移植性を考慮するならば使用しないこと。 

規 格- Project LIBC Group 

関連項目 - —dellastsep ， .tobslash, _toslash 
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Chapter1—C 標準関数ライ ブラ 、) 


abort 


用 途ーカレントプロセスを異常終了させる。 

書 式- #include < stdlib . h > 

void — volatile abort ( void ); 

解 説—— abort 関数はカレントプロセスを異常終了させるため，自プロセスに対して 

SIGABRT シグナルを送る。もし SIGABRT がキャッチされなかったり，キャッチさ 
れてもシグナルハンドラから戻ってくる場合には，プロセスは SIGABRT シグナル 
のデフォルトの動作を行う。すなわち，すべてのファイルストリーム，ファイル 
ハンドルはクローズされ，バッファリングされていたデータは書き出される。シ 
グナルハンドラから戻ってこない場合も，やはり結果的にブロセスは終了する。 

戻り値一なし。 abort 関数は決して戻ってこない。 

規 格一 ANSI C , P 0 S 1 XA 、 XPG 3, AES / OS ，4.3 BSD , SYSV 

関連項目—— exit , kill , raise , signal 







ライブラリー第 2 部 


abs 


用 途—— int 型の値の絶対値を取得する。 

書 式- #include < stdlib . h > 

int abs (mt n ;; 

解 説—— abs 関数は 《 の絶対値を返す。 

戻り値の int 型絶対値を返す。 

注 意——通常， abs 関数はマクロとして定義されるが， __ NO _ STDLIB _ INLINE __ が定義され 
た場合には実体をもつ関数となる。 

規 格 —— ANSI C , POSIX . l , XPG 3、 AES / OS ，4.3 BSD，SYSV 
関連項目- div ， labs , ldiv，wabs 
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Chapter 1— C 標準関数ライブラリ 


access 



用 途——ファイルにアクセスできるかどうかを調べる。 

書式- #mclude < unistd . h > 

mt access (const char * path , int amode ); 

解 説—— access 関数は /? 加/ 2 で指定されたファイルに，みで指定されたアクセスがで 
きるかどうかを調べる。みには次の4種類があり，それぞれの値の論理和を 
指定する。 

• R _0 K 読み込みの可否 

• W _0 K 書き込みの可否 

• X _0 K 実行の可否 

• F _0 K ファイルの有無 

戻り値——指定したアクセスが可能ならば0を，不可能ならば一1を返して，変数 errno に 
その原因を示すエラーコードを設定する。 


• EN0ENT ファイルが存在しない 

• EINVAL aim? ぬに不正な値を指定した 

• EL00P シンボリックリンクのネストか1采すぎるか，ループしている 

互換性—— Human68k にはユーザ ID やグループ ID の概念がないので， access 関数がこ 
れらの値に影響されることはない。 

Human68k のファイル管理方法では読み込み禁止ファイルを作成することは 
できない。よってすベてのファイルは読み込み可能であると仮定する。またファ 
イ ルが 実行可能であるかどうかは，ファイル名の拡張子が“ . X ”，“•!•”， “. Z ”, 
“•bat” であるか，実行属性ビットが設定されているかどうかで判定する。 

ただし，ディレクトリが実行可能とはディレクトリ内部へ移動することができる 
ということであり， Human68k ではつねに可能であると仮定する。 

規 格—— Project LIBC Group , POSIX . l , XPG 3, AES / OS , 4.3 BSD，SYSV 

関連項目- chmod, chown, stat 

変 更——従来では拡張子“. Z ” をもつものも実行ファイルとして認識していたが，現在の 

LiBC では認識しない。 “.Z” という拡張子は確かに Human68k での実行ファ 
イルにも使われるがその頻度は少なく，むしろ compress プログラムによる圧縮 
データを表すことのほうが多いためである。 
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ライブラリー第2部 


acos 


用 途-逆余弦 arccos ( a ;) を求める 0 

書 式-# include < math . h > 

double acos ^double x ); 

#include < sys / xmath . h > 
double _ f_acos (double x ); 
double _ fe_acos (double x ); 
double _ fpu_acos (double x ); 

解 説—— acos 関数はズの逆余弦（アークコサイン）を計算する。各関数はそれぞれ次のよ 

うに動作する。 

• acos 数値演算コプロセッサが使用できる場合は数値演算コプロセッサ 

を直接ドライブし，使用できない場合は FLOAT パッケージを呼 
び出す 

• _ f-acos 数値演算コブロセッサ命令を直接ドライブする 

• _ fe_acos FLOAT パッケージを呼び出す 

• _ fpu_acos I / O 数値演算コプロセッサを直接ドライブする 

戻り値——正しく値が求められた場合， acos 関数は一1ざ a ; ざ1の範囲内で； c の逆余弦を返 
す 0 結果は，0 s acos ( a ;) S 7 T (単位：ラジアン）の範囲の値である。もしズが非 
数 ( NaN ) だったならば，変数 errno にその原因を示す エラーコー ドを設定して， 
同じく非数を返す。 

• EDOM ズの値が非数，またはズの値が計算範囲外 

注 意—— Cmath . h 〉 を読み込む前に， __ DIRECT _ FLOAT „ j ^ 定義されているときは acos 

は _ fe _ acos の別名となり， __ DIRECT _ IOFPU __ i ^ 定義されているときは acos は 
jCpu _ acos の別名となる。また， __ DIRECT _ FPU __ が定義されているときは acos は 
- f . acos の別名となる。 

規 格 —— Project LIBC Group，ANSI C , POSIX . l , XPG 3, AES / OS ， 4.3 BSD ， 
SYSV 

関連項目- cos , isnan 
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Chapterl — C 標準関数ライブラリ 


acosh 


用 途-双曲逆余弦 arccosh ( x ) を求める。 

書 式- #include < math . h > 

double acosh kdouble x ); 

#include < sys / xmath . h > 
double _ f_acosh (double x ); 
double _ fe_acosh (double x ); 
double _ fpu_acosh (double x ); 

解 説—— acosh 関数は； c の双曲逆余弦（ハイパボリックアークコサイン）を計算する。各関 

数はそれぞれ次のように動作する。 


• acosh 


• jf.acosh 

• _f e_acosh 

• _ fpu_acosh 


数値演算コプロセッサが使用できる場合は数値演算コプロ 
セッサを直接ドライブし，使用できない場合は FLOAT パッ 
ケージを呼び出す 

数値演算コプロセッサ命令を直接ドライブする 

FLOAT パッケージを呼び出す 

I / O 数値演算コプロセッサを直接ドライブする 


戻り値——正しく値が求められた場合， acosh 関数は x > 1の範囲でズの双曲逆余弦を返す。 

もしズが非数 ( NaN ) だったならば，変数 errno にその原因を示すエラーコードを 
設定して同じく非数を返す。 

• EDOM X の値が非数，またはズの値が計算範囲外 


注 意一 < math . h > を読み込む前に， __ DIRECT _ FLOAT __ が定義されているときは acosh は 

_ fe _ acosh の別名となり， __ DIRECT _ IOFPU __ が定義されているときは acosh は 
_ fpu _ acosh の別名となる。また， __ DIRECT _ FPU __ が定義されているときは acosh 
は _ f - acosh の別名となる。 

規 格- Project LIBC Group 


関連項目- cosh , isnan 






ライブラリ ー 第2部 


alarm 


用 途——アラームシグナルを設定する。 

書 式- # include < nnistd . h > 

unsigned int alarm (unsigned int seconds ); 

解 説—— alarm 関数は，從 CW 2 み秒後に現在実行中のプロセスに対してアラームシグナル 

( SIGALRM ) が発行されるようにリアルタイムクロックを設定する。ただし seconds 
が0の場合は，現在設定されているアラームシグナルの予約を解除する。 

アラームシグナルは多重に設定することはできず，つねに一番最後に設定された 
ものが有効となる。 

また spawn や exec 系の関数， system 関数などで子プロセスが起動されると，そ 
の時点でアラームシグナルは中断され，子プロセス終了後に再度カウントを再開 
する。したがって，このような場合には正確な時間の計測は行えない。 

戻り値——現在アラームシグナルが予約されている場合は，そのシグナルが何秒後に生成さ 
れる予定なのかを数値で返し，予約されていないか，すでに発行後ならば0を 
返す。 

注 意ーアラームシグナルは，リアルタイムクロック （ RTC ) 割り込みを用いて実現されて 
いる。したがって alarm 関数を用いてアラームシグナルを予約すると，実際にシ 
グナルが発行されるまで，1/ 16 秒ごとに1回の割り込みが起こる。だが，割り込み 
処理は非常に軽いので，パフォーマンスには実質的な影響はない。しかし，それ 
だけの回数で割り込みが発生しているということについては注意する必要がある。 

また，割り込みが DOS コールの処理中に発生した場合は，安全のために 1 / 16 秒 
シグナルを遅らせる。 

規 格 —— Project LIBC Group , P 0 SIX .1, XPG 3, AES / OS ， 4.3 BSD，SYSV 
関連項目- exec , pause , raise ， sigaction , spawn , system 
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Chapter 1— C 標準関数ライブラリ 


alloca 


用 途——スタックフレームからメモリを害 I ]り当てる。 

書 式- #include < alloca . h > 

void *alloca 、 size_t size ); 

解 説—— alloca 関数は少なくとも • size バイトのメモリブロックを，実行中の関数のスタッ 

クフ レームから 割り当て，そのメモリブロックへのポインタを返す。メモリブ 
ロックは適切にアラインメント調整されるので，どんなボインタにでもキャスト 
することができる。 

なお割り当てられたメモリブロックは関数のスタックフレームに位置し ， alloca 
関数を呼び出した関数がより上位の閨数（呼び出し元）に return すると自動的に 
解放される。 

戻り値——正常にメモリブロックを割り当てられた場合は，そのメモリブロックへのポイン 
夕を返し，失敗した場合は NULL を返す。 

注 意—— alloca 関数を呼び出した関数が上位の関数（呼び出し元）へ return した後は，そ 

の関数内で割り当てたメモリブロックへのアクセスは保証されない。なぜならば， 
スタック フレームは 関数の呼び出しごとに破壊されるからである。 

alloca 関数は GCC のビルトイン関数を用いて実装されており，実体のある関 
数ではない。またスタックサイズ固定なので， alloca 関数を頻繁に使用するプロ 
グラムに対してはあらかじめ十分なサイズのスタック領域を与えておく必要があ 
る。万一，スタックオーバーフローが起こった場合，その動作は不定であり，一 
切保証されない。 

スタックサイズは，プログラムを起動する際にコマンドラインから指定すること 
もできる （- enargv 関数参照）が，あらかじめサイズを指定したい場合は，次のよ 
うに変数 _ stacksize をューザが明示的に定義しなければいけない。 

int _stacksize =128 * 1024; /* 128 Kbyte */ 

通常， alloca 関数はスタックチヱックを行わず， NULL を返すことはない。しか 
しく alloca . h 〉 が読み込まれる前に- _ ALLOCA _ STACK _ CHECK __ が定義された場合， 
alloca 関数は呼び出されるたびにスタックチェックを行うようになる。少なくと 
も alloca 関数に限っては，スタックオーバーフローを起こさないようになる。 

規 格- Project LIBC Group 


関連項目- _ enargv , free ， malloc , realloc 
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ライブラリー第 2 部 


asctime 


用 途——日付データを文字列に変換する。 

書 式- #include <time . h > 

char *asctime (const struct tm * timeptr ); 

解 説—— asctime 関数は r / m 印びが指す tm 構造体の内容 （ UTC ) を，次のような形式の文字 

列に変換する。 

Tue Nov 19 21:03:20 1991\ n \0 

戻り値一変換が成功した場合は変換された文字列へのポインタを返し，失敗した場合は 
NULL を返す。 

注 意-結果は gmtime 関数内部の静的領域に格納されるため， 10 caltime 関数 ， gmtime 

関数， asctime 関数， ctime 関数のいずれかの関数を呼び出すたびに内容が上書 
きされることに注意すること。 

規 格—— ANSI C，P0SIXA ， XPG3, AES/OS, 4.3BSD，SYSV 

関連項目- ctime , gmtime , localtime 
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Chapter 1 一 C 標準関数ライブラリ 


asin 


用 途-逆正弦 arcsin ( x ) を求める0 

書 式- #include < math . h > 

double asm (double x ); 

#include < sys / xmath . h > 
double _ f_asin (double x ); 
double _ fe_asin (double x ); 
double _ fpu_asin (double x ); 

解 説—— asin 関数はズの逆正弦（アークサイン）を計算する。各関数はそれぞれ次のよう 

に動作する。 

• asin 数値演算コプロセツサが使用できる場合は数値演算コプロ 

セッサを直接ドライブし，使用できない場合は FLOAT パツ 
ケージを呼び出す 

• _f _asin 数値演算コプロセッサ命令を直接ドライブする 

• _ fe_asin FLOAT パッケージを呼び出す 

• _ fpu_asin I / O 数値演算コプロセッサを直接ドライブする 

戻り値一正しく値が求められた場合， asin 関数は 一 1< x <1 の範囲でズの逆余弦を返 
す。結果は， 一 MS asin(x) < tt /2 (単位：ラジアン）の範囲の値である。もし 
I が非数 ( NaN ) だったならば，変数 errno にその原因を示すエラーコードを設定 
して同じく非数を返す。 

• EDOM X の値が非数，またはズの値が計算範囲外 

注 意一 < math . h > を読み込む前に， _ JDIRECT _ FLOAT __ が定義されているときは asin 
は _ fe _ asin の別名となり， __ DIRECT _ IOFPU __ が定義されているときは asin は 
_ fpu _ asin の別名となる。また， __ DIRECT _ FPU __ が定義されているときは asin は 
_ f _ asin の別名となる。 

規 格 一 Project LIBC Group，ANSI C 、 POSIX . l , XPG 3, AES / OS 、 4.3 BSD , 
SYSV 


関連項目- isnan , sin 
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ライブラリー第 2 部 


asinh 


用 途-双曲正弦 arcsin た(2；)を求める。 

書 式-# include < math . h > 

double asinh ^double x ); 

#include < sys / xmath . h > 
double _ f_asinh (double x ); 
double _ fe_asinh (double x ); 
double _ fpu_asinh (double x ); 

解 説—— asinh 関数は； c の双曲逆正弦（ハイパボリックアークサイン）を計算する。各関数 

はそれぞれ次のように動作する。 


• asinh 数値演算コプロセツザが使用できる場合は数値演算コプロ 

セツサを直接ドライブし，使用できない場合は FLOAT パツ 
ケージを呼び出す 

• _ f_asinh 数値演算コプロセツサ命令を直接ドライブする 

• _ fe_asinh FLOAT パッケージを呼び出す 


• _ fpu_asinh I / O 数値演算コプロセツサを直接ドライブする 


戻り値——正しく値が求められた場合， asinh 関数は； c の双曲逆正弦を返す。もし； c が非数 
( NaN ) だったならば，変数 errno にその原因を示すエラーコードを設定して同じ 
く非数を返す。 


• EDOM の値が非数だった 


注 意—— < math . h > を読み込む前に， __ DIRECT _ FLOAT __ が定義されているときは asinh は 

. fe.asinh の別名となり， __ DIRECT _ IOFPU __ が定義されているときは asinh は 
_ fpu_asinh の別名となる。また， __ DIRECT _ FPU __ が定義されているときは asinh 
は _f _asinh の別名となる。 

規 格- Project LIBC Group 

関連項目- isnan , sinh 
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Chapter 1— C 標準関数ライブラリ 


assert 


用 途—プログラム診断を行う。 

書 式- #include く assert . ti > 

void assert (int expression ); 

解 説—— assert 関数はプログラム中にプログラム診断文を挿入するときに用いる。つま 

り， assert 関数は expression で与えられた式を評価し，偽（〇)だった場合には標 
準 エラーメ ッ セージに 表示した後， abort 関数を呼び出してプロセスを異常終了 
させる。 

ただし，コンパイル時においてく assert 上〉を読み込む前に NDEBUG が定義され 
ていると， assert 関数はただの空文と置き換えられ，診断文は取り除かれる 0 

たとえば“ foo . c ” というプログラムの50行目に， assert 関数を次のように使用 
するとしよう。 

assert ((x + y ) < 3) ; 

これは，50行目の時点で x と y の和が3より小さくなくてはならないことを意味 
する。にもかかわらず，何らかの問題によって式 （x + y ) く 3の評価結果が偽 
になった場合， assert 関数は次のようなメッセージを出力して，プロセスを異 
常終了させる。 

Assertion failed : <(x + y ) < 3> at line 50 in file foo.c 

戻り値一なし。式の評価結果が偽ならば， assert 関数は決して戻ってこない 0 

注 意- NDEBUG は， 〈 assert 上〉を読み込む前に定義されていなくてはならない 0 

規 格 —— ANSI C , POSIX . l , XPG 3、 AES / OS ，4.3 BSD，SYSV 
関連項目- abort 
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ライブラリー第 2 部 


atari 


用 途-逆正接 ar ' cianb ) を求める0 

書 式- #inc lude < math . h > 

double atan ^aouble x ); 

#include < sys / xmath . h > 
double _ f_atan (double x ); 
double _ fe_atan (double x ); 
double _ fpu_atan (double x ); 

解 説—— atan 関数は； c の逆正接（アークタンジェント）を計算する。各関数はそれぞれ次 

のように動作する。 


• atan 数値演算コプロセッサが使用できる場合は数値演算コブロ 

セッサを直接ドライブし，使用できない場合は FLOAT パッ 
ケージを呼び出す 

• 丄 atan 数値演算コプロセッサ命令を直接ドライブする 

• _ fe_atan FLOAT パッケージを呼び出す 

• _ fpu_atan I / O 数値演算コプロセッサを直接ドライブする 


戻り値——正しく値が求められた場合， atan 関数は一1ざ a : ざ1の範囲で; c の逆正弦を返 
す。結果は 一 7 72 < atan(x) < ^/ 2 (単位：ラジアン）の範囲の値である。もしズ 
が非数 （ NaN ) だったならば，変数 eixno にその原因を示すエラーコードを設定し 
て同じく非数を返す。 


• EDOM ズの値が非数，またはズの値が計算範囲外 


注 意—— < math . h > を読み込む前に， __ DIRECT _ FLOAT __ が定義されているときは atan 

は- fe _ atan の別名となり， _ JDIRECT _ IOFPU __ が定義されているときは atan は 
_ fpu _ atan の別名となる。また， __ DIRECT _ FPU __ が定義されているときは atan は 
_f _ atan の別名となる。 

規 格 —— Project LIBC Group , ANSI C , POSIX . l 、 XPG3, AES / OS ，4.3 BSD ， 
SYSV 

関連項目- isnan , tan 
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Chapter 1 一 C 標準関数ライブラリ 


atan2 


用 途-逆正接 arotan ( y / x ) を求める0 

書式- #include < math . h > 

double atan 2 ^aouble y , doub 丄 e x ); 

#include < sys / xmath . h > 
double _ f _ atan 2 (double y , double x ); 
double _ fe _ atan 2 (double y , double x ); 
double _ fpu _ atan 2 (double y , double x ); 

解 説—— atan 2 関数は y / x の逆正接（アークタンジ i ント）を計算する。各関数はそれぞれ 

次のように動作する。 


• atan 2 数値演算コプロセツザが使用できる場合は数値演算コプロ 

セッサを直接ドライブし，使用できない場合は FLOAT パツ 
ケージを呼び出す 

• _ f _ atan 2 数値演算コプロセッサ命令を直接ドライブする 

• _ fe _ atan 2 FLOAT パッケージを呼び出す 


• _fpu_atan2 I/O 数値演算コプロセッサを直接ドライブする 


戻り値——正しく値が求められた場合， atan 2 関数は JC の逆正接を返す。戻り値の象限は， 
y ， x の符号によって決定する 0 結果は 一 7T ざ atan 2( y ，: r ) < 7T (単位： ラジアン） 
の範囲の値である。もしズが非数 （ NaN ) ならば，変数 errno にその原因を示すェ 
ラーコードを設定して同じく非数を返す。 

• EDOM ァ，ズの値が非数，ズの値が0または少，ズの値が計算範囲外 


注 意——く math , h 〉 を読み込む前に， __ DIRECT _ FLOAT __ が定義されているときは at an 2 は 
_ fe _ atan 2 の別名となり， __ DIRECT _ IOFPU __ が定義されているときは atan 2 は 
_ fpu . atan 2 の別名となる。また， __ DIRECT _ FPU __ が定義されているときは atan 2 
は- f _ atan 2 の別名となる。 

規 格 —— Project LIBC Group，ANSI C 、 POSIX . l 、 XPG 3, AES / OS ， 4.3 BSD 、 
SYSV 

関連項目- at an , isnan , tan 
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ライブラリー第 2 部 


atanh 


用 途-双曲逆正接狀が(271/1(0；)を求める。 


書 式- # include < math . h > 

double atanh (double x ); 

#include < sys / xmath . h > 
double _ f_atanh (double x ); 
double _ fe.atanh (double x ); 
double _ fpu_atanh (double x ); 

解 説 —— atanh 関数は； c の双曲逆正接（ハイパポリックアークタンジェント）を計算する。 

各関数はそれぞれ次のように動作する。 


• atanh 数値演算コプロセッサが使用できる場合は数値演算コブロ 

セッサを直接ドライブし，使用できない場合は FLOAT パッ 
ケージを呼び出す 

• _ f_atanh 数値演算コプロセッサ命令を直接ドライブする 

• _ fe_atanh FLOAT パッケージを呼び出す 


• _ fpu_atanh I / O 数値演算コプロセッサを直接ドライブする 


戻り値——正しく値が求められた場合， atanh 関数は一1 <rr <1の範囲で； c の双曲逆正接 
を返す 0 もし； c が非数 （ NaN ) だったならば，変数 errno にその 原因を示す エラー 
コードを設定して同じく非数を返す。 

• EDOM ズの値が非数，またはズの値が計算範囲外 

注 意—— < math . h > を読み込む前に， __ DIRECT _ FLOAT __ が定義されているときは atanh は 
_ fe _ atanh の別名となり， _ JDIRECT _ IOFPU — が定義されているときは atanh は 
_ fpu _ atanh の別名となる。また， __ DIRECT _ FPU __ が定義されているときは atanh 
は _f _ atanh の別名となる。 

規 格- Project LIBC Group 

関連項目- isnan , tanh 
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Chapter 1— C 標準関数ライブラリ 


atexit 


用 途——プロセス終了時に呼び出される関数を登録する。 

書 式- #include く stdlib . h 〉 

int atexit 、void (* func ) ^ void ；；; 

解 説—— atexit 関数は，で指定した関数をプロセスの正常終了時に呼び出される関 

数のリストに登録する。プロセスが正常終了すると，これら登録された関数は， 
登録された順番とは逆の順番（つまり最後に登録した順番）に引数なしで呼び出さ 
れる。 

正常終了とは， exit 関数によってプロセスを終了するか， main 関数から return 
した場合のことであり， abort 関数で終了させたり何らかのエラーで強制終了さ 
せられた場合のことではない。なお登録できる関数の数は，最大 ATEXIT _ MAX 個 
までである。 ATEXIT _ MAX はく limits . h > に定義されている。 

戻-り値——正常に登録できた場合は〇を返し，失敗した場合には〇以外の値を返して，変数 
errno にその原因を示すエラーコードを設定する。 

• EINVAL すでに ATEXIT _ MAX 個の関数が登録されているので，これ以上登 
録することはできない 

規 格 —— ANSI C，SYSV 

関連項目- abort ， exit , onexit , sysconf 
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ライブラリー第 2 部 


atof 


用 途——文字列を double 型倍精度浮動小数に変換する。 

書 式- # include < stdlib . h > 

double atof 、const char * nptr ); 

解 説—— atof 関数は，即かで指定された文字列を double 型倍精度浮動小数に変換する。 

変換は先頭の空白は無視し， null 文字に出会うか，数値に変換できない文字に出 
会うまで実行される。数値の最後には指数があってもよく，文字“ e ” か“ E ” に続 
く符合（省略可能）と指数値を正しく認識する。 

-3.1415926，1.8794 E +15, 2.42 e -6 

小数点として認識する文字は，ロケールの LC_NUMERIC カテゴリに影響される。 
戻り値一変換した結果を返す。 

注 意——変換した結果が double 型倍精度浮動小数で表現しきれない場合，その結果は不 

定となる。 LIBC は C ロケールしかサポートしていない。 

規 格一 Project LIBC Group，ANSI C 、 P 0 SIX .1, XPG 3, AES / OS ，4.3 BSD , 

SYSV 

関連項目- atoi , atol , strtod , strtol , strtoul 
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Chapter 1— C 標準関数ライブラリ 



用 途——文字列を符合つき int 型整数に変換する。 

書 式- #include < stdlib . h > 

mt atoi ^const char * nptr ); 

解 説一 atoi 関数は即//•で指定された文字列を符合つき int 型整数に変換する。変換は 

先頭の空白は無視し， mil 】 文字に出会うか，数値に変換できない文字に出会うま 
で行われる。 

戻り値——変換した結果を返す。 

注 意——変換した結果が符合つき int 型整数で表現しきれない場合，その結果は不定と 

なる。 

規 格一 ANSI C , P 0 SIX .1, XPG 3, AES / OS , 4.3 BSD , SYSV 
関連項目- at of , atoi , strtod , strtol , strtoul 
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ライブラリ ー 第2部 


atol 


用 途——文字列を符合つき long 型整数に変換する。 

書 式- #include < stdlib . h > 

long atol (const char * nptr ;; 

解 説—— atol 関数は，即 fr で指定された文字列を符合つき long 型整数に変換する。変換 

は先頭の空白は無視し， null 文字に出会うか，数値に変換できない文字に出会う 
まで行われる。 

戻り値——変換した結果を返す。 

注 意一変換した結果が符合つき long 型整数で表現しきれない場合，その結果は不定と 

なる。 

規格 —— ANSI C，P0SIX.1、XPG3, AES/OS, 4.3BSD, SYSV 
関連項目- atof , atoi , strtod , strtol，strtoul 
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Chapter 1— C 標準関数ライブラリ 



用 途一2つの領域の内容を比較する。 

書 式- #include く string . h > 

int bcmp (const void * region 2, const void * regionl , size_t n ); 

解 説—— bcmp 関数は， region1 と reg / ⑽ 2 で指定された領域の内容を《バイト分比較する。 

bcmp 閨数は strcmp 閨数とは異なり， null 文字を検出しても処理を中断しない。 

戻り値——比較の結果， 2 つの文字列がまったく同じならば bcmp 関数は 0 を返す。異なる 
場合，その位置での/^/⑽/侧の文字が/*哗2側の文字よりも大きい場合は正の 
値を，小さい場合は負の値を返す。 

注 意-1文字は1バイトとなる。 

規 格一 4.3BSD 

関連項目- memcmp , strcmp , strcoll , strncmp , strxfrm 
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ライブラリー第 2 部 


bcooy 


用 途 —領域を コ ピーする。 

書式- #include く string 上〉 

void *bcopy 、void * region 2, const void * regionl , size_t n ；; 

解 説 - bcopy 関数は，/*句如 22 の 指す領域から 《 バイトを の 指す領域にコピーす 

る。 bcopy 関数は strcpy 関数とは異なり， null 文字を検出しても处理を中断し 
ない0 

戻り値 -へのポインタを返す。 

注 意 -領域が重なっていた場合の動作は未定義である。 region 1は ，«バイトのデータを 

格納するのに十分な領域を指していなければならない。1文字は1バイトとなる。 

規 格—— 4.3BSD 

関埋項目 - memcpy , memmove , strcpy , strncpy 
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Chapter 1- C 標準関数ライブラリ 


brk 


用 途 ブレーク値を設定する0 

書 式 #include < stdlib . h > 

int brk ^void * addr ); 

解 説—— brk 関数は現在のブレーク値を如•で指定した値に設定する。ただし addr は, 

a ゴゴ/•以上のページ境界 （ LIBC では疑似的に4096バイトをページサイズとする） 
に整列される。 

ブレーク値とはプログラムのヒープ領域の最後尾のことをいい，ヒープ領域が負 
になったり， setrlimit 関数で指定されたリミット値を越えない範囲で変更する 
ことができる。またこのブレーク値は， malloc 関数などで新しいメモリを確保 
していくことで自動的に拡張される。 

戻り値一正常にブレーク値を設定できた場合は0を返し，失敗した場合には 一1 を返して， 
変数 ermo にその原因を示すエラーコードを設定する。 

• EN 0 MEM メモリが足りなくなったか，制限値に達した 

注 意—— L / 忍 (7 では，ブログラムのもつヒープ領域はプログラムの最後から連続して確保 

されていなくてはならない。したがって常駐プロセスなどがプロセスの後ろなど 
にロードされると，現在のメモリブロックの自由な拡張が阻害され，その結果, 
十分なフリーエリアがあるにもかかわらずメモリが足りなくなることがある。 

brk 関数はブレーク値を変更することでヒープ領域のサイズを変更することがで 
きるが，ヒープ領域がどのように使用されているかについては閨知しない。した 
がって，現在のサイズよりも縮小した場合には， malloc 関数などで得たメモリ 
領域が破壊されることがあるので注意すること。 

規 格一 Project LIBC Group ， XC ，4.3 BSD 

関連項目- chkml , rbrk , sbrk , sizmem 
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ライブラリー第 2 部 


bsearch 


用 途ーソート済みの配列に対してバイナリサーチを行う。 

書 式- #include < stdlib . h > 

void *bsearch ^const void * key , const void * base , 
size_t nmemb , size_t size , 

int (* compare ) (const void *, const void *)); 

解 説—— bsearch 関数は，化说が指す任意の配列からた町で指定されたデータをバイナリ 

サーチによって検索し，それが見つかった位置へのポインタを返す。検索される 
配列は，ぬ货から始まる個の項目 （1 項目は垃どバイト）であり，すでに 
比較関数 compare の仕様にしたがって正順にソートされていなければならない。 

bsearch 関数は検索を行うにあたり，必要に応じて関数作を用い，任意の 
2項目についてその大小を比較する。で指定した関数は，与えられた2 
項目を任意のアルゴリズムで比較し，1つ目の項目のほうが大きければ正の値，2 
つ目の項目のほうが大きければ負の値を，等しければ0を返す必要がある。 

戻り値——求めるデータが見つかった場合はその配列中の位置へのポインタを返し，見つか 
らなかった場合には NULL を返す。 

注 意——配列はすでに正順にソートされていなければならない。もし正しくソートされて 

いない場合は求めるデータが見つからないなど，どのような結果になるかについ 
ては未定義である。 

配列中に求めるデータが2つ以上ある場合， bsearch 関数がどちらのデータへの 
ポインタを返すかは未定義であり，状況によって変化する。 

規 格一 ANSI C, P0SIX.1, XPG3, AES/OS， 4.3BSD， SYSV 


サンプル—— \mmm\ 


• 比較関数の例 


1 ： /* 

2: ** 任意の2つの整数を比較するための比較関数の例。 

3: ** compare_int (const void *datal,const void *data2); 

4: **1 番目の項目が大きければ正，逆なら負，等しければ 0 を返す。 

5: */ 

6 : 

7: 11 it compaLre_int (const void *datal, const void 本 data2) 

8: { 

9 : const int *il=(const int *) datal; 

10: const int *i2 = (const int *) data2; 

11: return (int) (*il- *±2) ; 

12 : > 
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Chapter 1— C 標準関数ライブラリ 


bzero 


用 途一領域を〇で埋める。 

書式 - #include 〈 string. h> 

void *bzero (void ♦region, size_t n); 

解 説- bzero 関数は r 印7_〇/2の指す領域からバイトを〇で埋める。 bzero 関数は strset 

関数とは異なり， null 文字を検出しても処理を中断しない。 

戻り値-へのポインタを返す。 

注 意——1文字は1バイトとなる。 

規 格 —— 4.3 BSD 

関連項目 - memchr, memcmp, memcDV, memmove, memset 
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ライブラリー第 2 部 


calioc 


用 途——メモリブロックを確保する。 

書 式- # include < stdlib . h > 

void *calloc 、 size_t nmember , size_t size ); 

解 説—— calioc 関数は， 1 項目が s 加バイトのデータ/2/72所2&；*個分の配列に相当するメ 

モリ領域をヒープ領域から確保し，そのメモリ領域へのポインタを返す。確保さ 
れたメモリ領域は，あらかじめすべて〇でクリアされる。 

また確保されたメモリ領域の先頭アドレスは，いかなるデータ型にでもキャスト 
可能なように CPU 依存のアラインメントに調整される。 

戻り値——正常に確保できた場合はその領域へのポインタを返し，失敗した場合には NULL 
を返して，変数 eixno にその原因を示す エラーコー ドを設定する。 

• EN 0 MEM メモリが足りなくなつたか，制限値に達した 

規格—— ANSI C，POS1X.1、XPG3, AES/OS, 4.3BSD，SYSV 
関連項目- brk ， free , malloc , rbrk , realloc , sbrk 
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Chapter 1— C 標準関数ライブラリ 


ceil 


用 途—— z 以上の整数のなかで最も小さな数を返す。 

書式- #include < math . h > 

double ceil rouble x ); 

解 説—— ceil 関数はズ以上の値をもつ整数のなかで最も小さな数を返す。 

戻り値——正しく値が求められた場合はその値を返す。もし； C が非数 （ NaN ) ならば，変数 
errno にその原因を示す エラー コードを設定して同じく非数を返す。 

• EDOM X の値が非数，または土 HUGE - VAL である 

注 意——つねに FLOAT パッケージを呼び出す。 

規 格 —— Project LIBC Group，ANSI C、POSIX.l，XPG3, AES/OS, 4.3BSD, 

SYSV 

関連項目- fabs , floor , fmod 
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ライブラリー第 2 部 


cgets 


用 途—コンソールから直接 1 行入力する。 

書 式- # include く conio . li > 

char *cgets ^char * buff ); 

解 説—— cgets 関数はコンソールから 1 行分のデータを入力し，が指す領域に格納す 
る。ただし 61 £ガ[ 0 ]には，読み込みを行う領域のサイズを unsigned char 型の 
データで 設定しておく必要がある。 

読み込みは指定したバイト数を読み込むか改行コードに出会うまで行われ，実際 
に読み込まれたバイト数が 6 以ガ[ 1 ]に設定される。したがって読み込まれたデー 
夕は， 6 咕 [ 2 ] から格納されることになる。 

cgets 関数はつねに コンソールから 直接データを読み取るため，標準入力の状態 
に左右されることも， stdio ライブラリによるバッファリングの作用も受けな 
い。また， cgets 関数は 1 行を入力するまで待つが，すでにキーボードバッファ 
にデータがある場合や ungetch 関数によって押し戻されたデータがある場合は， 
それらからもデータを取得する。 

戻り値—— buffl2-] のアドレスを返す。エラーはない。 

注 意——読み込みバイト数は ， unsigned char 型で表現できる範囲に限られる。また，構 

造上 0x00 の文字コードは取得することができない。 

ゐがは結果を格納するだけの十分な大きさの領域を指していなければならない。 

規 格一 Project LIBC Group， MS-C7.0 
関連項目- fgets , getch ， getche , gets 
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Chapter 1 一 C 標準関数ライブラリ 


chdir 


用 途 ー カレントワーキングディレクトリを変更す る。 

書式 - #mclude < unista . h > 

int chdir 、 const char * path ); 

解 説 一 chdir 関数は，カレントワーキングディレクトリを淡で指定したディレクトリ 
に変更する。 



戻り値——正しくワーキングディレクトリを変更できた場合は0を，失敗した場合には_1 
を返して，変数 errno にその原因を示すエラーコードを設定する。 

• ENOENT path で指定したディレクトリが存在しない 

• ENOTDIR で指定したパス名にディレクトリ以外の要素が含まれて 

いる 

• EL 00 P シンボリックリンクのネストが深すぎるか，ループしている 


互換性——にドライブ名が含まれていた場合， XC , MS - C 7.0 などではそのドライブの 
カレントワーキングディレクトリを変更するだけだが， ZJBC では同時にカレン 
トドライブをそのドライブに変更する。 

規 格 —— Project LIBC Group , POSIX . l , XPG 3, AES / OS 、4.3 BSD , SYSV 

関連項目- chdrive , getcwd , getdcwd 
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ライブラリ ー 第2部 


chdrive 


用 途——カレントドライブを変更する。 

書式-# include < unistd . h > 

int chdrive (mt drive ); 

解 説—— chdrive 関数は，カレントドライブをめ 7 V どで指定したドライブに変更する。 drive 
は A : ドライブを1とし，以降2が B : ドライブ，3が C : ドライブという順番に指 
定する。 

戻り値——正しくドライブを変更できた場合は0を返し，失敗した場合には一1を返して，変 
数 errno にその原因を示す エラーコー ドを設定する。 

• EXDEV 不正なドライブ drive を指定した 

規 格 —— Project LIBC Group, MS-C7.0 
関連項目- chdir , getcwd , getdcwd 
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Chapter 1— C 標準関数ライブラリ 


chkml 


用 途——空きメモリ容量をバイト単位で調べる。 

書 式- #include <stdlib . h > 

size_t chkml ^ void ); 

解 説 —— chkml 関数は空きメモリ容量，正確には連続して確保できる最大の空きメモリブ 

ロックのサイズを調べ，結果をバイト単位で返す。 

戻り値一空きメモリ容量をバイト単位で返す。 

注 意——正確な空きメモリ容量とは異なる。また，ここでいう空きメモリブロックとは 

Human 68 k が管理しているメモリブロックのことであり，プロセスのヒープ領 
域から確保されるメモリブロック（管理するのはプロセス自身）ではない。 

規 格- Project LIBC Group , XC 

関連項目- brk，sizmem 
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ライブラリー第 2 部 



用 途——ファイルのアクセスモードを変更する。 

書 式- # include <stat . h > 

int chmod (const char * name , mode_t mode ); 

解 説—— chmod 関数は⑽ we で指定したファイルのファイルモードを， wo みで指定する値 
に変更する。 mo みに指定することができるのは次のとおりで，それぞれの値の 
論理和を指定する。 

• S-IEXEC 実行ファイル，チェンジディレクトリ可能 

• S.IWRITE 書き込み可 

• SJCREAD 読み込み可 

戻り値——正常にアクセスモードの変更ができた場合は0を返し，失敗した場合は一1を返 
して，変数 erxno にその原因を示す エラーコー ドを設定する0 


• EN0ENT ファイルが見つからない 

• EN0ENT 不正なドライブを指定した 

• EPERM ボリュームファイルを変更しようとした 

互換性—— Human 68 k ではファイルに実行属性や読み込み禁止属性を設定することはでき 
ないので（実行属性については execd を使えば可能)， S-IEXEC や S.IREAD は疑似 
的に作り出される値である。 

規 格 ^— Project LIBC Group ， POSIX . l ， XPG 3, AES / OS ，4.3 BSD , SYSV 

関連項目- fchmod, fstat, _mode2dos, stat 

変 更——従来では S-IEXEC によってファイルの実行属性を設定していたが（実行属性につ 

いては execd の機能)，これは標準的な環境では余計な動作となるため廃止した。 
代わりに現在の•では， S_IEXBIT を指定することで実行属性だけを個別に 
設定できるようにした。 

• S_IEXBIT 実行属性ビット 
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Chapter 1— C 標準関数ライブラリ 



用 途ーファイルのオーナーおよびグループを変更する。 

書 式- #include < unistd . h > 

int chown (const char * path ， uid_t owner , gia_t group ); 


解 説—— chown 関数は，で指定されたファイルのオーナー ID およびグループ ID を変 

更する。 


戻り値——正常に変更できた場合は〇を返し，失敗した場合には 一1 を返して，変数 errno 
にその原因を示すエラーコードを設定する。 

• EN 0 ENT ファイルが存在しない 

• EL 00 P シンボリックリンクのネストが深すぎるか，ループしている 

互換性—— Human 68 k にはユーザ ID やグループ ID の概念がないので， chown 関数がこれ 
らの値に影響されることはない。また厶仿 C 内では，デフォルトの仮想ユーザ ID 
および仮想グループ ID を root と仮定しているため， chown 関数は何ら影響をお 
よぼさないとはいえ，変更は必ず成功する。 

規 格 —— Project LIBC Group , POSIX . l ， XPG 3、 AES / OS , 4.3 BSD , SYSV 
関連項目- chmod , fchmod , fchown 
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ライブラリー第 2 部 


chsize 


用 途——ファイルの長さを変更する。 

書 式- # include < unistd . h > 

int chsize (int fildes , int len ;; 

解 説—— chsize 関数は， fildes が指す' 7 了イルの長さを len バイ トに変更する。もし/州が 
現在のファイルサイズよりも短い場合は，その間のデータはすべて捨てられ，反 
対に長い場合はすべて0のデータで埋められる。 

ただし， chsize 関数はキャラクタデバイスに対しては動作しない。また，ファイ 
ルは書き込み可能であること。 

戻り値——正常に変更できた場合は0を返し，失敗した場合には 一1 を返して，変数 erxiio 
にその原因を示す エラーコード を設定する。 

• EBADF 不正な fildes を 指定した 

• ER 0 FS リードオンリーファイルシステムである 

規 格 —— Project LIBC Group ， MS - C 7.0 

関埋項目- ere at , f truncate ， open , truncate 
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Chapter 1 一 C 標準関数ライブラリ 


clearenv 


用 途ープロセスの環境変数テーブルをクリアする。 

書 式- #include < stdlib . h > 

int clearenv ( void ); 

解 説—— clearenv 関数はプロセスの環境変数テーブルをクリアする 0 つまり ， clearenv 

関数を実行した後はすべての環境変数が未定義となる。 

戻り値——正しくテーブルをクリアできた場合は〇を返し，失敗した場合には一1を返して， 
変数 errno にその原因を示す エラーコー ドを設定する 0 

• EN 0 MEM メモリが足りなくなった 



注 意ークリアされる環境変数テーブルはプロセス内部にコピーされた環境変数テーブル 
であり，親プロセスの環境変数テーブルや Human 68 k の環境変数テーブルはク 
リアされない。 

clearenv 関数を実行すると変数 environ が変化するため，以前のボインタ値に 
対するアクセスは保証されない。また，のなかには環境変数を参照する関 
数もあるが，参照がどの時点で行われるかは関数に依存するので，必ずしもクリ 
アすることによって影響を受けるとは限らない。 

規 格 —— Project LIBC Group ， POSIX.l 


関連項目- environ , exec , getenv , putenv , spawn 
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ライブラリー第 2 部 


clearerr 


用 途——ファイルストリームのエラーおよび終端指示子をクリアする。 

書 式-# include <stdio .h> 

void clearerr (FILE *stream;; 

解 説- clearerr 関数は，が指すファイルストリームのエラ ー 指示子および終端 

指示子をクリアする。ファイルストリーム関数のなかには，これらの指示子の状 
態によってはつねにエラーとなるものがある。 

戻り値—— clearerr 関数には戻り値はない 0 

注 意ーファイルストリームに エラー 指示子が設定されている場合，変数 errno にその原 
因を示す エラー コードを設定する。ただし変数 errno の値は，ファイル操作の直 
後しか保証されない。 

規 格一 ANSI C , POSIX . l 、 XPG 3, AES / OS , 4.3 BSD，SYSV 

関連項目- feof, ferror 
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Chapter 1 一 C 標準関数ライブラリ 


clock 


用 途一起動してから現在までの経過時間を測定する。 

書式- #include <time . h > 

clock.t clock ( void ); 



解 説—— clock 関数は，プログラムが起動してから呼び出された時点までの経過時間を返 
す。 clock 閨数で使用する値は，マシンが起動してからの経過時間を10ミリ秒単 
位で表したものである。秒単位の実時間を求めるには，この値を CLOCKSJPER_SEC 
で割ればよい。 


戻り値——プログラムが起動してから clock 関数が呼び出されるまでの経過時間を，1〇ミ 
リ秒単位で返す。 

注 意ープログラムが起動してから24時間以上経過すると，正しい経過時間を得ること 

ができない。古い AiVSJ (7 規格では， CL 0 CKS _ PER _ SEC は CLK - TCK となっていた。 


規 格一 ANSI C ， XPG 3, AES / OS , SYSV 
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ライブラリー第 2 部 


close 


用 途ーファイルをクローズする。 

書式-# include < unistd . h > 

int close unt f ildes ); 

解 説一 close 関数は，で指定したファイルハンドルが指すファイルをクローズす 

る。その結果， ftldes を通してのファイル了クセスはできなくなる。 また，クロー 
ズする前に皿 link 関数によって削除を予約されたファイルは， close 関数が実 
行されると実際に削除される。 

戻り値一正常にクローズできた場合は0を返し，失敗した場合には 一1 を返して，変数 
errno にその原因を示す エラーコー ドを設定する。 

• EBADF 不正な fildes を 指定した 

注 意一 close 関数と unlink 関数は UNIX 上の皿 link システムコールをシミュレート 

しているが， Human 68 k のファイルシステムではリンクカウントを保持できな 
いため，つねにカウントは1として扱っている。 

また，その実現方法は完全ではないので，理論的には削除予約したはずのファ 
イルが正しく削除されずに残ってしまうこともありえる。したがって皿 link 関 
数は，ファイルをクローズした後に行うのが望ましいだろう。 

規 格—— ANSI C , POSIX . l , XPG 3、 AES / OS , 4.3 BSD，SYSV 

関連項目- creat , dup , fclose , fcntl , fopen , open , unlink 
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Chapter 1— C 標準関数ライブラリ 


closeair 


用 途——デイレクトリストリームをクローズする。 

書 式- #include <dirent . h > 

void closedir (DIR * dirp ); 

解 説一 closedir 関数は，ゴ // p で指定するディレクトリストリームをクローズし，構造 
体を解放する。 

戻り値-なし。 

規 格一 Project LIBC Group , POS 1 X .1， XPG 3, AES / OS ， 4.3 BSD，SYSV 

関連項目- closedir , readdir ， rewinddir ， seekdir , telldir 
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ライブラリー第 2 部 


commit 


用 途——ファイルアクセスのバッファをフラッシュする。 

書 式- #include < unistd . h > 

mt commit (mt Hides); 

解 説—— commit 関数は， fildes で指定したファイルハンドルが指すファイルをアクセスす 
るために用いられているファイルバッファをフラッシュし，内容をディスク上に 
反映させる。 

戻り値——正常にフラッシュできた場合は0を返し，失敗した場合には 一1 を返して，変数 
errno にその原因を示すエラーコードを設定する。 

• EBADF 不正な fildes を 指定した 

注 意—— commit 関数が影響をおよぼすファイルバッファとは， “ config . sys ” の FILES = 
行で指定される Human 68 k の内部バッファであり ， LIBC がもっバッフ了でも 
なければ stdio ライブラリのそれでもない。 

互換性"一 Human 68 k では，このバッファフラッシュはファイルハンドルごとに個別に行 
うことができない。したがって co 腿 it 関数は，現在オープンされているすべて 
のファイルに対して影響をおよぼす。 

規 格 —— Project LIBC Group ， MS - C 7.0 

関埋項目- ere at , open , read , write 
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Chapter 1— C 標準関数ライブラリ 


COS 


用 途 -余弦 cos (X) を求める。 

書 式 - #include < math . h > 

double cos (double x ); 

#include < sys / xmath . h > 
double _ f_cos (double x ); 
double _ fe_cos (double x ); 
double _ fpu_cos (double x ); 

解 説 —— cos 関数は ； c (単位：ラジアン）の 余弦（コサイン） を計算する。各関数はそれぞ 
れ次のように動作する。 

• cos 数値演算コプロセッサが 使用できる場合は数値演算コプロセッサ 

を直接ドライブし，使用できない場合は FLOAT パッケージを呼 

び出す 

• _ f_cos 数値演算コプロセッサ命令を直接ドライブする 

• _ fe_cos FLOAT パッケージを呼び出す 

• _ fpu_cos I / O 数値演算コプロセッサを直接ドライブする 

戻り値 ——正しく値が求められた場合， cos 関数はズの余弦を返す 0 もしズが非 数 （ NaN ) な 
らば，変数 errno にその原因を示すエラーコードを設定して同じく非数を返し， 
それ以外では計算結果を返す。ただし計算結果は不正確な値になる。 

• EDOM X の値が非数，または士 HUGE—VAL 

• ERANGE X の値が大きく計算結果の有効桁が一部失われる場合，またはズ 

の値が非常に大きくて計算結果の有効桁が完全に失われる場合 

注 意 一く math . h 〉 を読み込む前に， -_ DIRECT _ FLOAT __ が定義されているときは cos は 

_ fe . cos の別名となり， 」 DIRECT _ IOFPU __ が定義されているときは cos は _ fpu_cos 
の別名となる。また， __ DIRECT _ FPU __ が定義されているときは cos は _ f _ cos の別 
名となる。 

数値演算コプロセッサの場合のみ， ERANGE が設定される。 

規 格 —— Project LIBC Group , ANSI C , POSIX . l , XPG 3, AES / OS ，4.3 BSD , 
SYSV 


関連項目 - acos , isnan 
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ライプラリー第 2 部 


cosh 


用 途-双曲余弦 cos/i(a:) を求める。 

書 式-# include <math. h> 

double cosh rouble x); 

#include <sys/xmath.h> 
double _f_cosh (double x); 
double _fe_cosh (double x); 
double _fpu_cosh (double x); 

解 説—— cosh 関数は； c の双曲余弦 （ハイパ ポリックコ サイン） を計算する。各関数はそれ 

ぞれ次のように動作する。 


• cosh 数値演算コプロセッサが使用できる場合は数値演算コブロセッ 

サを直接ドライブし，使用できない場合は FLO AT パッケージを 
呼び出す 

• -f.cosh 数値演算コプロセッサ命令を直接ドライブする 

• _fe_cosh FLOAT パッケージを呼び出す 

• _fpu_cosh I/O 数値演算コプロセッサを直接ドライブする 


戻り値-正しく値が求められた場合， cosh 関数はズの双曲余弦を返す。もしズが非数 (NaN) 

ならば，変数 errno にその原因を示すエラーコードを設定して同じく非数を返 
し，それ以外では無限大を返す。 

• EDOM X の値が非数だった 

• ERANGE 計算結果が才ーバーフローした 


注 意—— <math.h> を読み込む前に， _JDIRECT_FLOAT__ が定義されているときは cosh 

は _fe_cosh の別名となり， __DIRECT_IOFPU__ が定義されているときは cosh は 
_fpu_cosh の別名となる。また， __DIRECT_FPU__ が定義されているときは cosh は 
_f _cosh の別名となる。 

数値演算コプロセッサの場合のみ， ERANGE が設定される。 

規 格 —— Project LIBC Group , ANSI C ， POSIXA 、 XPG 3, AES / OS ， 4.3 BSD ， 
SYSV 


関連項目 - acos ， cos, isnan 
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Chapter 1 一 C 標準関数ライブラリ 


cpnntT 


用 途一直接コンソールへフォーマット出力する。 

■rf xi - #mclude < conio . n > 

int cpnntf 、 const char * iormat ,...); 

解 説- cprintf 関数は， yb / wa / で指定した表示フォーマットにしたがって引数をコン 

ソールに直接表示する。 cprintf 関数は，機能的には printf 関数と似ているが， 
stdio ライブラリによるバッファリングの作用は一切受けない。 

また出力はつねにコンソールに対して行われるので，標準出力，標準エラー出力 
などの状態に左右されることはない。さらにテキスト，バイナリモードの区別も 
ないので，行末の CRLF を LF に変換する作業も行われない。 

表示フォーマットの指定は printf 関数を参照のこと。 

戻り値一実際にコンソールに出力した文字数を返す。エラーはない。 



規 格 —— Project LIBC Group , MS - C 7.0 
関連項目- fprintf , printf , sprintf 
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ライブラリー第 2 部 


CpUTS 


用 途-直接コンソールへ1行出力する 0 

書 式- # include く conio . h 〉 

int cputs (const char * string ); 

解 説—— cputs 関数は，打/7せで指定した文字列をコンソールに直接表示する 。 cputs m 

数は，機能的には puts 関数と似ているが， stdio ライブラリによるバッファリ 
ングの作用は一切受けない。 

出力は null 文字に到達するまで行われる。また，つねにコンソールに対して行わ 
れるので，標準出力，標準エラー出力などの状態に左右されることはない。さら 
にテキスト，バイナリモードの区別もないので，行末の CRLF を LF に変換する作 
業も行われない。 

cputs 関数は行末の CRLF を自動的に出力することはない。 

戻り値一正常に出力できた場合は〇を返す。エラーはない。 

規 格 —— Project LIBC Group , MS - C 7.0 
関連項目- cprintf , fputs , puts 
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Chapter 1— C 標準関数ライブラリ 


creat 


用 途 新しいファイルの作成と書き込みモードで才ープンする。 

書 式^- #include < fcntl . h > 

mt creat (const char * path , mode_t mode ); 

解 説- creat 関数は， p がみで指定されたファイルを似?みで指定したファイルアクセス 

モードで新規に作成し，そのファイルを書き込みモードで才ープンする。ただし 
すでに同名のファイルが存在した場合は，そのファイルを一度サイズ0に切り 
詰めて内容を破棄してからオープンする。その場合ファイルのファイルアクセス 
モードは，すでに存在していたファイルのファイルアクセスモードと同じになり， 
77 K ? みは無視される。 

mode に指定することができるファイルアクセスモードは次のとおり。 

• S_IREAD 読み込み可能（つねにこれは指定される） 

• S.IWRITE 書き込み可能 

creat 関数は open 関数に対して次の指定をした場合と同じなので，詳細な動作 
については open 関数の説明を参照のこと。 

open ( path , O.WRONLY I D.CREAT I 0_ TRUNC , mode ) 



戻り値——正常にファイルをオープンできた場合はそのファイルハンドルを，失敗した場合 
は一 1 を返し，変数 errno にその原因を示すエラーコードを設定する。 


• EISDIR ディレクトリである 

• EMFILE これ以上ファイルをオープンできない 

• EN 0 SPC ディスタがいっぱいである 

• EL 00 P シンボリックリンクのネストが深すぎるか，ループしている 

互換性一 Human 68 k では読み込み禁止属性のファイルを作成することはできないので， 
S.IREAD の指定/未指定に関わらず，すべてのファイルは読み込み可能となる。 

規 格 —— Project LIBC Group , POSIX . l , XPG 3、 AES / OS , 4.3 BSD , SYSV 

関連項目- open 
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ライブラリー第 2 部 


ctermid 


用 途——現在のコントロール端末の名称を取得する。 

書式 -# include <unistd.h> 

char *ctermid (char *s); 

解 説—— ctermid 関数はカレントプロセスのコントロール端末の名称をパス名の形で取得 

し， *5 が NULL でなければ S の指す領域に， S が NULL ならば関数内部の静的領域に 
その結果を コピーす る。 

戻り値——正常に取得することができた場合，その結果がコピーされた領域へのポインタを 
返し，失敗した場合には空文字列がコピーされる。 

注 意——が NULL でなければ， J は最低 L-Ctermid バイトの領域を指していなければなら 
ない。また J が NULL ならば， ctermid 関数の静的領域は呼び出しごとに上書き 
されることに注意すること。なお L_ctermid はく stdio.li> で定義されている。 

互換性—— Human68k ではコントロール端末という概念がないため， ctermid 関数では標 
準入力のデバイスを調べ，ブロックデバイスならば“ con” を，キャラクタデバイ 
スならばその名前を返す。 

規 格 —— Project LIBC Group ， POSIX . l , XPG 3, AES / OS ， 4.3 BSD，SYSV 

関連項目- ttyname 
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ctime 


用 途——日付データを文字列に変換する。 

書 式- #include <time . h > 

char *ctime (const struct tm * timeptr ); 

解 説—— ctime 関数は， rfm 印かが指す tm 構造体の内容 （ UTC ) を，地域時間情報の設定に 
したがって地域時間に変換し，次のような形式の文字列に変換する。 

Tue Nov 19 21:03:201991 \ n \0 
ctime 関数は，地域時間情報を得るために tzset 関数を呼び出す。 

戻り値一-変換が成功した場合は変換された文字列へのポインタを返し，失敗した場合は 
NULL を返す0 



注 意——結果は gmtime 関数内部の静的領域に格納されるため， localtime 関数 ， gmtime 

関数， asctime 関数， ctime 閨数のいずれかの関数を呼び出すたびに内容が上書 
きされることに注意すること。 


規 格一 ANSI C ， POSIXA , XPG 3、 AES / OS ，4.3 BSD , SYSV 
関連項目- asctime , gmtime , localtime 
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cuserid 


用 途ー ユーザの ログイン名を取得する。 

舊式- # include < unistd . h > 

char *cuserid (char * s ); 

解 説—— cuserid 関数は現在の ユーザの ログイン名を取得し， S が NULL でなければ S の 指 

す領域に， J が NULL ならば cuserid 関数内部の静的領域に，その結果をコピー 
する。 

戻り値一正常に取得することができた場合は，その結果がコピーされた領域へのポインタ 
を返す。失敗した場合には， J が NULL でなければ空文字がコピーされ， J が NULL 
ならば NULL を返す。 

注 意—— S が NULL でなければ，は最低 L _ cuserid バイトの領域を指していなければなら 
ない 0 また J が NULL ならば， cuserid 関数の静的領域は呼び出しごとに上書き 
されることに注意すること。なお L . cuserid はく stdio 上〉で定義されている。 

互換性" 一 - Human 68 k はシングル ユーザ 用であるため， ユーザ 管理に関する概念がない。 

そのため cuserid 関数では， ksh ， bash , fish , minsh などのシヱルと同様， 
環境変数 USER あるいは L 0 GNAME からログイン名を取得することにしている。 

規 格一 Project LIBC Group , P 0 SIX .1, XPG 3, AES / OS , SYSV 

関連項目- getlogin , getpwnam , getpwuid 
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一 dehupair 


用 途——コマンドライン文字列を個々の引数に分解する。 

書 式- #include く sys/xstart . li > 

int _ dehupair 、const char * com , char * buff ); 

解 説—— - dehupair 関数は com で指定したコマンドライン文字列を解析し，1つの引数が 

1つの文字列となるようにし，その結果をゐが指す領域に格納する。 

各引数はスペースによって区切られ，引数の頭の余分な空白はすべて取り除かれ 
る。ただし，ダブルクォーテーションマークやシングルクォーテーションマーク 
によって必要な部分をクォートすることができる。 

たとえば， com が次のような文字列を指していた場合， 
argl arg 2 J arg 3 arg 4 J arg 5\0 

結果としての指す領域には，次のようなデータが格納されることになる。 
argl \0 arg 2\0 arg 3 arg 4\0 arg 5\0 

戻り値一文字列を分解した結果，取り出せた引数の数を返す。引数が1つもなかった場合 
は0を返す。 

規 格- Project LIBC Group 

関連項目- _ enargv , - main , —start 
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—dellastsep 


用 途ーパス名の最後のパス区切り記号を削除する。 

書 式-# include < sys/xglob . h > 

char *_ dellastser > (char * path ); 

解 説—— -dellastsep 関数は，パ认で指定されたパス名の最後のパス区切り記号を削除す 
る。ただし，区切り記号が存在しない場合は何も行わない。 

戻り値^ - path を返す。 

注 意——ではパス区切り記号は“/”と“\”の両方を認識するが，結果はすべてスラッ 
シュ“/”になるように変換される。 

-dellastsep 関数はライブラリの内部関数なので，移植性を考慮するならば使用 
しないこと。 

規 格 —— Project LIBC Group 

関連項目 - _ addlastsep , _ tobslash , _toslash 


52 






Chapter 1 一 C 標準関数ライブラリ 


difftime 


用 途——2つの時刻の差を計算する。 

書式- #include <t ime . h > 

double difftime ( time_t newtime , time_t oldtime ); 

解 説一 difftime 関数は oldtime から newtime にいたるまでの時間を秒単位で計算し，そ 

の結果（差）を倍精度浮動小数に変換して返す。 

戻り値一秒単位の時間差 oWhme - neWime を倍精度浮動小数に変換して返す。 

注 意—— difftime 関数は，デフォルトではマクロとして定義され，実体をもたないが， 

__ NO _ TIME _ INLINE __ が定義された場合は実体をもつ関数となる。 

規 格一 ANSI C ， POSIX . l , XPG 3, AES / OS ， 4.3 BSD , SYSV 

関連項目- clock , time 
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用 途—— int 型整数の除算を行う。 

書 式- #include < stdlib . h > 

div_t div (int number , mt denom ); 

解 説—— div 関数は int 型の整数である number を み⑽ m で割った商と剰余を求める〇商 

と剰余の符合は，引数の符合が同じであれば正，異なれば負となる。 t た denom 
で割り切れない場合，計算結果は代数学上の商よりも小さい最大の整数となる。 

戻り値——除算の結果を div_t 構造体に代入し，その構造体を返す。構造体の定義は次のと 
おりで， quot に商を， rem に剰余を格納する。 

struct i 

int quot ; /* 商 */ 

int rem ; /* 剰余*/ 

>； 

注 意——変換した結果が int 型で表現しきれない場合，その結果は不定である。 

規 格 —— ANSI C , SYSV 

関連項目- floor , ldiv 
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drand 


用 途一実数の乱数を生成する。 

書 式' #include < stdlib . h > 

double drand 、 void ); 

解 説—— drand 関数は O . O ^ rgl . O の範囲で実数の乱数を生成し，その値を返す。 

戻り値——0.0の範囲の乱数を double 型で返す。 

注 意——乱数シードを設定しない場合は，デフォルトとしてシードに1が用いられる。 

互換性一 STSF などにも同様の関数があるが，そちらは乱数生成アルゴリズムとして Linear 
Congruential Algorithm と48 ビット整数演算を用いているため， drand 48 とい 
う名前である。1/及 C では異なるアルゴリズムを用いているので， drand 48 とは 
しなかった。 

規 格- Project LIBC Group 

関連項目- rand , random , srand，srandom 
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用 途——ファイルハンドルを複製する。 

書 式- #include < unistd . h > 

mt dup ^mt f lldes ); 

解 説一 dup 関数はガゴがで指定したファイルハンドルが指しているファイルに対して，新 

しいファイルハンドルを割り当てる。複製後はどちらのファイルハンドルを通し 
ても，結果的に同じファイルを操作することになる。 

新しく割り当てられるファイルハンドルは，その時点で使用されていないファイ 
ルハンドルのなかで最も小さい番号のものとなる。 

戻り値——正常に複製できた場合は新しく割り当てられたファイルハンドルを返し，失敗し 
た場合には一1を返して，変数 errno にその原因を示すエラーコードを設定する 0 

• EBADF 不正なファイルハンドルを指定した 

• EMFILE これ以上ファイルハンドルを割り当てられない 

規 格 —— POSIX . l ， XPG 3, AES / OS , 4.3 BSD , SYSV 

関連項目- close , creat ， dup 2, fcntl , open 
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用 途——ファイルハンドルを複製する0 

書 式- #include < unistd . h > 

int dup 2 (int fildesl,int fildes 2); 

解 説一 du P 2 関数は， fildesl と fildes2 が m じ値を指すように， fildes2 を新たにオープン 
する。ただしすでにガゴが2が使用されていた場合は，複製の前に^のファイ 
ルハンドルを クローズ する。複製後はどちらのファイルハンドルを通しても，結 
果的に同じファイルを操作することになる。 

fildesl ヒ JUdes2 が同 じだった場合は，何も行わずに正常終了する。 

戻り値——正常に複製できた場合はガゴが2を返し，失敗した場合には 一1 を返して，変数 
errno にその原因を示すエラーコードを設定する。 

• EBADF 不正なファイルハンドルを指定した 

規 格一 POSIX . l ， XPG 3, AES / OS ，4.3 BSD , SYSV 

関連項目- close , creat , dup ， fcntl , open 
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ライブラリー第 2 部 


—enarav 


用 途——前処理済みのコマンドラインから引数配列を作成する。 

書 式-— #mclude く sys / xstart . h > 

int _enargv (const char * prog,int argc , 

char ** argv , const char * com ); 

解 説一 _enargv 関数は，で指定された前処理（個々の引数に分離）されたコマンドラ 
イン文字列と /?/* 呀で指定されたカレントプロセスのファイル名から引数配列を作 
成し，その結果を aav が指す領域に格納する。弓|数配列は char ** 型で，弓|数文 
字列へのボインタの配列である。 

たとえば foobar というプログラムにおいて， argc が 4 ： で com が次のようになっ 
ていたとすると， 


argl \0 arg 2\0 picnic \0 this is a pen \0 


結果として，次のような引数配列が作成される。ここで 0 /*ぎ v [ n ] は， com 文字 
列の内部を指している。 


argv L 0] = 、char *) 
argv [ l] = kchar *) 
argv [2] = (char *) 
argv [3] = (char *) 
argv [4] = (char *) 


" foobar "; 

" argl "; 

" arg 2"; 

" picnic "; 

"this is a pen "; 


また， — enargv 関数はライブラリ自身に対するオプションを見つけると，これら 
を適切に処理し，ユーザプログラムに渡す引数配列には含めないようにする。ラ 
イブラリに指定することができるオプションは次のとおりである。 

• -+- h : bytes ヒープ領域の初期サイズを bytes [こする 

• -+- s : bytes スタック領域のサイズを bytes にする 

• -+-p プログラムを スーパーバイザモー ドで実行させる 

• -+-f 数値計算で FLOAT パッケージを使用するようにする 

• -+-g 強制的に C ++ の グローバル コンストラクタ/デストラクタを 

起動する 
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戻り値——最終的にユーザプログラムに渡される引数の数，すなわち生成された引数配列の 
大きさを返す。 

注 意——スタック領域のサイズ，ヒープ領域のサイズチヱックは行われないので，不正な 

値を指定したときの動作は一切保証されない。 


規 格- Project LIBC Group 

関埋項目- - dehimair ，_ main，.start 
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用 途一 Human68k のエラーコードをライブラリのエラーコードに変換する。 

書 式-# include <sys/xglob.h> 

int _errcnv (int doserrno); 

解 説 - ^errcnv 関数は，ゴで指定した Human68k のシステム エラーコー ドを， 

ライブラリで使用するライブラリ エラーコー ドに変換する。 

戻り値-ゴ0^/7770に対応するライブラリエラーコードを返す。 

注 意ーシステムエラーコードとライブラリエラーコードは1対1で対応しているわけで 

はないので，必ずしも適切な変換が行われるとはかぎらない。 

-errcnv 関数はライブラリの内部関数なので，移植性を考慮するならば使用しな 
いこと。 

規 格- Project LIBC Group 

問埋項目 - perror, strerror 
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ecvt 


用 途——浮動小数値を指数形式の数字列に変換する。 


書 式- #include <stdlib . h > 

char *ecvt Rouble value , mt prec , mt * dec,int * sign ); 

解 説一 ecvt 関数は va / 從で指定した浮動小数を指数形式の文字列に変換し，その文字列 
へのポインタを返す。変換は全体の桁数が/? rec 桁になるように行われ， value の 
符号が沿:^の，小数点が先頭から何バイト目の直前にくるかがみ c の指す領域に， 
それぞれ格納される。これらから指数値を求めるには，小数点の位置から1を引 
けばよい〇 

全体の桁数が/桁に満たないようならば足りない分だけ“0” を後ろに追加し， 
桁数が最低でも/?/桁になるようにする。たとえば，次のような結果を返す。 



ecvt (+3.14159000, 3) str 
ecvt (+0.31415900, 3) str 
ecvt (-0.03141590, 3) str 
ecvt (-0.00314159, 3) str 


, 314 , 

, 314 , 

, 314 , 

，314, 


dec =1 prec = 0 
dec = 0 prec = 0 
dec =-1 prec =1 
dec = -2 prec =1 


戻り値——変換した文字列を格納した関数内部の静的領域へのポインタを返す。 

注 意——数値は + 1 桁目で四捨五入によって丸められる。 

結果は ecvt 関数内部の静的領域に格納されるため， fcvt 関数や ecvt 関数を呼 
び出すたびに内容が上書きされることに注意すること。 

また printf 関数や sprintf 関数などのフォーマット出力関数は，内部で浮動小 
数を出力する際に ecvt 関数や fcvt 関数を用いているため，これによって静的領 
域が破壊されることがある。 

互換性——本来ならば printf 関数などのように，ライブラリ自体がライブラリ内部の静的 
領域を破壊することは避けなければならないが，現在の仕様では上記のような事 
例が起こり得る。 

規 格 —— Project LIBC Group , XC 、 MS - C 7.0 

関連項目- fcvt , gcvt 
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endqrent 


用 途——グループファイルへのアクセスを終了する。 

書 式- # include < grp . h > 

void endgrent 、 void ); 

解 説- endgrent 関数は， setgrent 関数や getgrent 関数などでアクセス中のグループ 

ファイルへのアクセスを終了する。 

getgrnam 関数や getgrgid 関数のインタフヱイスを用いずにグループを検索す 
る場合は，明示的に endgrent 関数によってアクセスを終了すること 0 

戻り値-なし。 

規 格 —— Project LIBC Group ，4.3 BSD，SYSV 
関埋項目- getgrent , getgrgid , getgrnam , setgrent 
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endpwent 


用 途——パスワードファイルへのアクセスを終了する。 

書 式- #include く pwd . li > 

void endpwent ( void ) ; 

解 説—— endpwent 関数は， setpwent 関数や getpwent 関数などでアクセス中のパスワー 

ドファイルへのアクセスを終了する。 

getpwnam 関数や getpwuid 関数のインタフヱイスを用いずにグループを検索す 
る場合は，明示的に endpwent 関数によってアクセスを終了すること。 

戻り値一なし。 

規 格 —— Project LIBC Group , 4.3 BSD，SYSV 

関連項目—— getpwent , getpwnam , getpwuid , setpwent 
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environ 


用 途——環境変数テーブル。 

書 式- #include < unistd . h > 

extern char ホ* environ ; 

解 説——変数 environ は環境変数テーブルであり，個々の環境変数へのボインタの配列で 

ある。個々の環境変数とは “rmme= ⑽沁 e” というフォーマットの文字列であり， 
1環境変数が1文字列で表現されている。 

注 意一ここでいう環境変数テーブルとは，プロセスの内部にコピーされた環境のことを 

指し，親プロセスや Human68k の環境変数テーブルのことではない。また変数 
environ は， putenv 関数や clearenv 関数の実行によって変化することがある 
ため，その値をコピーしたボインタは必ずしもテーブルへのアクセスを保証され 
ない。 

規 格^ POS 1 X .1 ， XPG 3, AES / OS 、4.3 BSD , SYSV 

関連項目- clearenv , exec , getenv , putenv , spawn 
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eprintf 


用 途—— 標準エラー出カファイルストリームにフォーマツト出力を行う。 

書 式- #include く stdio . il > 

int eprintf ^const char * format ,...); 

解 説一 eprintf 関数は， / orw がで指定したフォーマツト文字列にしたがって引数を文字 
列に変換し，結果を標準エラー出力に割り当てられたファイルストリームに出力 
する。 

フォーマツト文字列の指定の方法や詳細な説明については， fprintf 関数を参照 
のこと。 

戻り値——正常に出力できた場合は出力した文字数を返し，失敗した場合は EOF を返してス 
ト リームの エラー指示子を設定する。失敗した場合は，変数 errno に その 原因を 
示す エラー コードを設定する。 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

規 格- Project LIBC Group 

関連項目- fprintf , printf , sprintf 


65 







ライブラリー第 2 部 


execl 


用 途—プログラムを実行する。 

書 式— 一 #include < unistd . h > 

int execl (const char * path , const char * argO ,...); 

解 説—— execl 関数は現在実行中のプログラムに代わり， par / z で指定したプログラムを 

起動して制御を移す 0 したがって execl 関数が正常に処理された場合， execl 関 
数は戻らず，また現在実行中のプログラムもこれ以降処理されない。 

execl 関数には以ざ以降に，任意の数の引数列（文字列の集合）を渡すことがで 
き，起動されるブログラムに引数として渡される。 C のプログラムは起動される 
と main 関数に argc と という引数配列が渡されるが， 0 /客0からの一連の引 
数は，この argv 配列を直接指定していることと同じである。ただし， fl ^ v [0] は 
プログラム自身を表すので，普通は/?が/ z と同じ値を設定する。また引数列の最 
後に，終端記号として NULL を指定すること。 

戻り値一正常に実行できた場合は execl 関数は戻ってこないが，失敗した場合には 一1 を 
返して，変数 errno にその原因を示すエラーコードを設定する。 

• E 2 BIG 引数列が多すぎる 

• ENOENT paM で指定されたプログラムが見つからない 

• EL 00 P シンボリックリンクのネストが深すぎるか，またはループしている 

• EN 0 MEM メモリが足りなくなった 

注 意——実行しようとするプログラムが HUPAIR 仕様に準拠したプログラムならば，引 

数は HUPAIR 仕様にしたがって エンコードされ， プログラムに渡される。逆 
に， HUPAIR 仕様に準拠していないプログラムの場合， Human 68 k で規定さ 
れている通常の方法によって引数が渡される。 


互換性一 Human68k には UNIX の exec 関数と同等の概念がないので，では spawn 
関数を流用して， exec 関数を疑似的に作り出している。起動するプログラムはつ 
ねに子プロセスとして起動されるが，その子プロセスが終了すると親ブロセスも 
即座に終了するため，見かけ上は exec 関数と同じになる 0 ただし上記のような 
理由で，内部的には一度親プロセスへ戻らなければならず，親プロセスが atexit 
関数や onexit 関数で設定した後，処理ルーチンが呼び出されてしまう。 

規 格 —— Project LIBC Group ， P 0 SIX .1， XPG 3, AES / OS , 4.3 BSD , SYSV 
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関連項目 ' ~-execle, execlp, execv, execve, execvp 






Chapter 1— C 標準関数ライブラリ 


execle 


用 途ープログラムを実行する。 


書 式- #include < unistd . h > 

int execle (const char 木 path , const char * argO , 
char *const envp []); 

解 説—— execle 関数は現在実行中のプログラムに代わり， path で指定したプログラムを 

起動して制御を移す 0 したがって， execle 関数が正常に処理された場合 ， execle 
関数は戻らず，また現在実行中のプログラムもこれ以降处理されない。 

execle 関数には arg 以降に，任意の数の引数列（文字列の集合）を渡すことがで 
き，起動されるプログラムに引数として渡される。 C のプログラムは起動される 
と， main 関数に wgc と argv という引数配列が渡されるが， argO からの一連の 
引数は，この flrgv 配列を直接指定しているのと同じである。ただし似 gv [0] は 
プログラム自身を表すため，普通は/?が/2と同じ値を設定する。また引数列の最 
後に，終端記号として NULL を指定すること。 

execle 関数は実行す るプログラムに与える 環境エリアを，⑼ vp の配列で指定す 
ることができる（⑼ V /?は引数列の最後に設定される NULL の次である）。実行さ 
れるプログラムが，もし getenv 関数などによって環境変数を検索しようとする 
と，この配列の内容が検索されることになる。この配列の構造については変数 
environ を参照のこと。 



戻り値——正常に実行できた場合は execle 関数は戻ってこないが，失敗した場合には 一1 を 
返して，変数 erxiio にその原因を示すエラーコードを設定する。 


• E 2 BIG 引数列が多すぎる 

• EN 0 ENT /?が A で指定されたプログラムが見つからない 

• EL 00 P シンボリックリンクのネストが深すぎるか，またはループしている 

• EN 0 MEM メモリが足りなくなった 

注 意——実行しようとするブログラムが HUPAIR 仕様に準拠したブログラムならば，引 
数は HUPAIR 仕様にしたがってエンコードされ，プログラムに渡される。逆 
に， HUPAIR 仕様に準拠していないプログラムの場合， Human 68 k で規定さ 
れている通常の方法によって引数が渡される。 
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ライブラリー第 2 部 


互換性—— Human 68 k には UNIX の exec 関数と同等の概念がないので， L 仿 (7 では spawn 
関数を流用して， exec 関数を疑似的に作り出している。起動するプログラムはつ 
ねに子プロセスとして起動されるが，その子プロセスが終了すると親プロセスも 
即座に終了するため，見かけ上は exec 関数と同じになる 0 ただし上記のような 
理由で，内部的には一度親プロセスへ戻らねばならず，親プロセスが atexit 関 
数や onexit 関数で設定した後，処理ルーチンが呼び出されてしまう 0 

規 格 —— Project LIBC Group ， P 0 SIX .1, XPG 3, AES / OS ， 4.3 BSD，SYSV 

関連項目- execl , execlp , execv , execve , execvp 
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Chapter 1— C 標準関数ライブラリ 


execlp 


用 途—プログラムを実行する。 

■rf 式- frinc 丄 ude < unistd . h > 

mt execlp ^const char * iile , const char * argO , …）； 

解 説—— execlp 関数は現在実行中のプログラムに代わり，处で指定したプログラムを起 

動して制御を移す。したがって execlp 関数が正常に処理された場合， execlp 関 
数は戻らず，また現在実行中のプログラムもこれ以降処理されない。 

execlp 関数には以降に，任意の数の引数列（文字列の集合）を渡すことがで 
き，それらは起動されるプログラムに引数として渡される。 C のブログラムは 
起動されると main 関数に argc と ar ぎ v という引数配列が渡されるが， argO から 
の一連の引数は，この “ rgv 配列を直接指定しているのと同じである。ただし， 
argv [0] はプログラム自身を表すため，普通は处と同じ値を設定する。また引 
数列の最後に，終端記号として NULL を指定すること。 

呼び出されるプログラムは Ji/e で指定する。もし 如が‘7” や“\”のようなパス 
の区切り記号を含んでいれば，如はプログラムのパスを示しているとみなされ 
る 0 しかし区切り記号が含まれていなければ， execlp 関数は处という名前の 
ファイルを環境変数 path に設定されているディレクトリのなかから検索し，最 
初に見つかったものを実行する。 

戻り値一正常に実行できた場合は execlp 関数は戻ってこないが，失敗した場合には 一1 を 
返して，変数 erxno にその原因を示すエラーコードを設定する。 

• E 2 BIG 引数列が多すぎる 

• EN 0 ENT 命で指定されたプログラムが見つからない 

• EL 00 P シンボリックリンクのネストが深すぎるか，またはループしている 

• EN 0 MEM メモリが足りなくなった 


注 意——実行しようとするプログラムが HUPAIR 仕様に準拠したプログラムならば，引 

数は HUPAIR 仕様にしたがって エンコードされ， プログラムに渡される。逆 
に， HUPAIR 仕様に準拠していないプログラムの場合， Human 68 k で規定さ 
れている通常の方法によって引数が渡される。 
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ライブラリー第 2 部 


互換性—— Human 68 k には UNIX の exec 関数と同等の概念がないので，では spawn 
関数を流用して， exec 関数を疑似的に作り出している 0 起動するプログラムはつ 
ねに子プロセスとして起動されるが，その子プロセスが終了すると親プロセスも 
即座に終了するため，見かけ上は exec 関数と同じになる。ただし上記のような 
理由で，内部的には一度親プロセスへ戻らねばならず，親プロセスが atexit 関 
数や onexit 関数で設定した後，処理ルーチンが呼び出されてしまう 0 

規 格 —— Project LIBC Group , P 0 SIX .1, XPG 3, AES / OS ， 4.3 BSD，SYSV 

関連項目- execl , execle , execv , execve , execvp 
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Chapter 1— C 標準関数ライブラリ 


execv 


用 途—プログラムを実行する。 

書 式- #include < unistd . h > 

int execv (const char * path , char *const argv 口）； 

解 説—— execv 閨数は現在実行中のプログラムに代わり，ル认で指定したプログラムを 

起動して制御を移す。したがって execv 関数が正常に処理された場合， execv 関 
数は戻らず，また現在実行中のプロダラムもこれ以降処理されない。 

execv 閨数には flrgv で任意の数の引数列（文字列の集合）を渡すことができ，そ 
れらは起動されるプログラムに引数として渡される。 C のプログラムは起動され 
ると main 関数に argct argv という引数配列が渡されるが， execv 関数で指定 
する argv は，この main 関数の argv 配列を直接指定していることと同じである。 
ただし flav [0] はプログラム自身を表すので，普通は/? aM と同じ値を設定する。 
また引数配列の最後に，終端記号として NULL を指定すること。 

戻り値——正常に実行できた場合は execv 関数は戻ってこないが，失敗した場合には 一1 を 
返して，変数 errno にその原因を示すエラーコードを設定する 0 


• E 2 BIG 引数列が多すぎる 

• EN 0 ENT /?が//で指定されたプログラムが見つからない 

• EL 00 P シンボリックリンクのネストが深すぎるか，またはループしている 

• EN 0 MEM メモリが足りなくなった 

注 意——実行しようとするプログラムが HUPAIR 仕様に準拠したブログラムならば，引 

数は HUPAIR 仕様にしたがってエンコードされ，プログラムに渡される。逆 
に， HUPAIR 仕様に準拠していないプログラムの場合， Human68k で規定さ 
れている通常の方法によって引数が渡される。 

互換性—— Human68k には UNIX の exec 関数と同等の概念がないため， L7BC では spawn 
関数を流用して exec 関数を疑似的に作り出している 0 起動するプログラムはつ 
ねに子プロセスとして起動されるが，その子プロセスが終了すると親プロセスも 
即座に終了するため，見かけ上は exec 関数と同じになる 0 ただし上記のような 
理由で，内部的には一度親プロセスへ戻らねばならず，親プロセスが atexit 関 
数や onexit 関数で設定した後，処理ルーチンが呼び出されてしまう。 

規 格—— Project LIBC Group , POS 1 XA ， XPG 3, AES / OS ， 4.3 BSD , SYSV 


関連項目 - execl ， execle ， execlp, execve，execvp 
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ライブラリー第 2 部 


execve 


用 途——プログラムを実行する。 

書 式- # include く unistd . il > 

int execve (const char * path , char *const axgv [] 
char * const envp []); 

解 説—— execve 関数は現在実行中のプログラムに代わり，で指定したプログラムを 

起動して制御を移す 0 したがって execve 関数が正常に処理された場合 ， execve 
関数は戻らず，また現在実行中のプロダラムもこれ以降処理されない。 

execve 関数には似がで任意の数の引数列（文字列の集合）を渡すことができ，そ 
れらは起動されるプログラムに引数として渡される。 C のプログラムは起動時さ 
れると main 関数に argc と argv という引数配列が渡されるが， execve 関数で指 
定する argvli , この main 関数の flrgv 配列を直接指定していることと同じであ 
る。ただし at 方 v [0] はプログラム自身を表すので，普通は/7がゐと同じ値を設定 
する。また引数配列の最後に，終端記号として NULL を指定すること。 

execve 関数は実行するプログラムに与える環境エリアを，⑼ vp の配列で指定す 
ることができる（⑼ vp は引数列の最後に設定される NULL の次である)。実行さ 
れるプログラムが，もし getenv 関数などによって環境変数を検索しようとする 
と，この配列の内容が検索されることになる。この配列の構造については変数 
environ を参照のこと。 

戻り値——正常に実行できた場合は execve 関数は戻ってこないが，失敗した場合には 一 1を 
返して，変数 errno にその原因を示すエラーコードを設定する 0 

• E 2 BIG 引数列が多すぎる 

• EN 0 ENT /?が / Z で指定されたプログラムが見つからない 

• EL 00 P シンボリックリンクのネストが深すぎるか，またはループしている 

• EN 0 MEM メモリが足りなくなった 

注 意——実行しようとするプログラムが HUPAIR 仕様に準拠したプログラムならば，引 
数は HUPAIR 仕様にしたがって エンコードされ， プログラムに渡される。逆 
に， HUPAIR 仕様に準拠していないプログラムの場合， Human 68 k で規定さ 
れている通常の方法によって引数が渡される。 
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Chapter 1— C 標準関数ライブラリ 


互換性—— Human 68 k には UNIX の exec 関数と同等の概念がないので， L /5 C では spawn 
関数を流用して， exec 関数を疑似的に作り出している。起動するプログラムはつ 
ねに子プロセスとして起動されるが，その子プロセスが終了すると親プロセスも 
即座に終了するため，見かけ上は exec 関数と同じになる。ただし上記のような 
理由で，内部的には一度親プロセスへ戻らねばならず，親プロセスが atexit 関 
数や onexit 関数で設定した後，処理ルーチンが呼び出されてしまう。 

規 格 —— Project LIBC Group ， P 0 SIX .1， XPG 3, AES / OS , 4.3 BSD，SYSV 

関連項目一 — execl , execle , execlp ， execv , execvp 
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ライブラリー第 2 部 


execvp 


用 途—ブログラムを実行する。 

書 式- #include < unistd . h > 

int execvp const char * fiie , char * const axgv [j ;; 

解 説—— execvp 関数は現在実行中のプログラムに代わり，如で指定したプログラムを起 

動して制御を移す。したがって execvp 関数が正常に処理された場合， execvp 関 
数は戻らず，また現在実行中のプログラムもこれ以降処理されない。 

execvp 関数には似 gv で任意の数の引数列（文字列の集合）を渡すことができ，そ 
れらは起動されるプログラムに引数として渡される。 C のプログラムは起動され 
ると main 関数に argc h argv という引数配列が渡されるが， execvp 関数で指定 
する flrgv は，この main 関数の wgv 配列を直接指定しているのと同じである。た 
だし argv [0] はブログラム自身を表すので，普通は处と同じ値を設定する。ま 
た引数配列の最後に，終端記号として NULL を指定すること。 

呼び出されるプログラムは如で指定する。もし处が“/”や“\”のようなパス 
の区切り記号を含んでいれば，如はプログラムのパスを示しているとみなされ 
る 0 しかし区切り記号が含まれていなければ， execvp 関数は如という名前の 
ファイルを環境変数 path に設定されているディレクトリのなかから検索し，最 
初に見つかったものを実行する。 

戻り値——正常に実行できた場合は execvp 関数は戻ってこないが，失敗した場合には 一1 を 
返して，変数 errno にその原因を示す エラーコー ドを設定する 0 

• E 2 BIG 引数列が多すぎる 

• EN 0 ENT 如で指定されたプログラムが見つからない 

• EL 00 P シンボリックリンクのネストが深すぎるか，ループしている 

• EN 0 MEM メモリが足りなくなった 


注 意一実行しようとするプログラムが HUPAIR 仕様に準拠したプログラムならば，引 

数は HUPAIR 仕様にしたがって エンコードされ， プログラムに渡される。逆 
に， HUPAIR 仕様に準拠していないプログラムの場合， Human 68 k で規定さ 
れている通常の方法によって引数が渡される。 
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Chapter 1 一 C 標準関数ライブラリ 


互換性—— Human 68 k には UNIX の exec 関数と同等の概念がないので，では spawn 
関数を流用して， exec 関数を疑似的に作り出している 0 起動するプログラムはつ 
ねに子プロセスとして起動されるが，その子プロセスが終了すると親プロセスも 
即座に終了するため，見かけ上は exec 関数と同じになる 0 ただし上記のような 
理由で，内部的には一度親プロセスへ戻らねばならず，親プロセスが atexit 関 
数や onexit 関数で設定した後，処理ルーチンが呼び出されてしまう。 

規 格 —— Project LIBC Group ， P 0 SIX .1, XPG 3, AES / OS , 4.3 BSD , SYSV 

関連項目'—— execl , execle ， execlp , execv , execve 
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ライブラリー第 2 部 


exit 


用 途—プロセスを終了させる。 

書 式- #include < stdlib . h > 

void — volatile exit (int exitcode ;; 

解 説一 exit 関数は現在実行中のブロセスを終了し，その終了コードとして exitcode を 

指定する。 

exit 関数はまず atexit 関数で登録された関数を順番に実行し，次にオープンさ 
れていたすベてのファイルハンドル，ファイルストリームをクローズする。そし 
て tmpfile 関数でオーブンしたテンポラリファイルを削除し， C ++ のグローパ 
ルデストラクタを起動する。 

戻り値一 exit 関数は決して呼び出し側には戻ってこない。 

注 意——オーブンファイルのクローズやテンポラリファイルの削除， C ++ の グロー バル 

デストラクタの起動は，実際には exit 関数から呼び出される — exit 関数によっ 
て行われる。 

規 格 —— Project LIBC Group , ANSI C ， POSIX . l , XPG 3, AES / OS ，4.3 BSD ， 
SYSV 

関連項目- atexit , close , fclose , tmpfile 
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Chapter 1— C 標準関数ライブラリ 


exp 


用 途一 e 1 を求める。 


書 式- #include く math . h > 

double exp (double x ); 
#include < sys / xmath . h > 
double _ f_exp (double x ); 
double _ fe_exp (double x ); 
double _ fpu_exp (double x ); 


解 説一 exp 関数は，ネイピア数 e を底とする指数； c の累乗#を求める。各関数はそれぞ 

れ次のように動作する。 

• exp 数値演算コプロセッサが使用できる場合は数値演算コプロセッサ 

を直接ドライブし，使用できない場合は FLOAT パッケージを呼 
び出す 

• _ f_exp 数値演算コプロセッサ命令を直接ドライブする 

• _ fe_exp FLOAT パッケージを呼び出す 

• _ fpu_exp I / O 数値演算コプロセッサを直接ドライブする 



戻り値——正しく値が求められた場合， exp 関数は〇:〉0の範囲でズの指数を返す。もしも 
ズが非数 （ NaN ) ならば，変数 errno にその原因を示すエラーコードを設定して同 
じく非数を返し，それ以外では無限大を返す。 

• EDOM JC の値が非数 

• ERANGE 計算結果がオーバーフロー，またはアンダーフロー 


注 意—— < math . li 〉 を読み込む前に， __ DIRECT _ FLOAT __ が定義されているときは exp は 

_ fe _ exp の別名となり， __ DIRECT _ IOFPU __ が定義されているときは exp は _ fpu_exp 
の別名となる。また， — DIRECT _ FPU — が定義されているときは exp は _ f _ exp の別 
名となる。 

数値演算コプロセッサの場合のみ， ERANGE が設定される。 

規 格一 Project LIBC Group, ANSI C 、 POSIX.l , XPG3, AES/OS ， 4.3BSD 、 
SYSV 

関連項目- isnan , log , loglO , pow 
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ライブラリー第 2 部 


—fpuofr 


用 途——数学ライブラリを FLOAT パッケージ呼び出しにする。 

書式- #include < sys / xmath . h > 

void _ fpu_off ( void ); 

解 説一 _ fpu _ off 関数は数値演算コプロセッサの有無にかかわらず，これ以降に呼び出さ 
れる数学ライブラリ関数を FLOAT パッケージ呼び出しで動作させる。 LIBCH , 
起動時に数値演算コプロセッサの有無に応じて演算ルーチンを切り替えるように 
なっているため，どうしても FLOAT パッケージを使用したい場合には _ fpu_off 
関数を用いなければならない。 

戻り値——なし。 

注 意—— _ fpu _ off 関数はライブラリの内部関数なので，移植性を考慮するならば使用しな 
いこと。 

規 格- Project LIBC Group 

関連項目- - fpu.on 
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Chapter 1— C 標準関数ライブラリ 


_fpu—on 


用 途——数学ライブラリを数値演算コプロセッサ直接駆動にする。 


書 式^- #include <sys/xmath.h> 

void _fpu_on 、void); 

解 説 一 _fpu_on 関数は数値演算コプロセツサが使用できる場合，これ以降に呼び出され 

る数学ライブラリ関数を数値演算コプロセッサ直接駆動で動作させる。 LIBC は， 
起動時に数値演算コプロセッサの有無に応じて演算ルーチンを切り替えるように 
なっている。そのため，明示的に FLOAT パッケージおよび数値演算コプロセッ 
サを指定するには， _fpu_oii 関数を用いなければならない。 



戻り値一なし。 


注 意——関数はライブラリの内部関数なので，移植性を考慮するならば使用しな 
いこと。 


規 格 '— Project LIBC Group 

関連項目- _fpu_off 
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ライブラリー第 2 部 


—fullentry 


用 途ーファイル名をフルパスに展開する。 

書 式- #include < sys / xstdlib . h > 

char *_fullentry (char * dst , const char * src , size_t maxlen ); 

解 説- _fullentry 関数はで指定したファイル名をフルパスに展開し，ゴ对の指す 

maxlen バイト の領域にコピーする。 -fullentry 関数は _fullpath 関数とは異な 
り，ディレクトリエントリの展開は行わない。 

foo /. — > A :/ foo /. 
too /.. A :/ foo /.. 

仮想ドライブのファイル名については，物理ドライブのフルパスに展開する。た 
とえば，ディレクトリ A:/foo がドライブ V :に割り当てられていた場合，次のよ 
うになる。 

V: /file — A :/ foo/file 

なお，仮想ディレクトリのファイル名は物理ドライブが存在しなくなるため，通 
常ファイルと同等に展開する。 

戻り値——正常に展開できた場合は如を返し，失敗した場合は NULL を返して，変数 errrio 
にその原因を示す エラーコー ドを設定する。 

• ERANGE 展開したファイル名を格納する領域が足りない 

• EN 0 ENT 不正なドライブを指定した 

注 意—— _ fullentr y 関数はライブラリの内部関数なので，移植性を考慮するならば使用 

しないこと。 


規 格- Project LIBC Group 

関連項目- —do s—get as sign ， _ dos _ nameck , _ ful 丄 path 
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Chapterl—C 標準関数ライブラリ 


fulloath 


用 途——ファイル名をフルパスに展開する。 

僅 式- #include < stdlib . h > 

char *_fullpath (char * dst , const char * src , size^t maxlen ); 

解 説—— - fullpath 関数はで指定されたファイル名をフルパスに展開し，ゴ打の指す 
maxlen バイト の領域にコピーする。 — fullpath 関数は _ fullentry 関数とは異な 
り，ディレクトリエントリの展開も行う。 

foo /. — A : /f 〇〇 
foo /.. —> A :/ 



仮想ドライブのファイル名については，物理ドライブのフルパスに展開する。た 
とえば，ディレクトリ A :/ foo がドライブ V :に割り当てられていた場合，次のよ 
うになる。 


V:/file -> A :/ foo/file 


なお仮想ディレクトリのファイル名は，物理ドライブが存在しなくなるため通常 
ファイルと同等に展開する。 

戻り値——正常に展開できた場合はゴ於を返し，失敗した場合は NULL を返して，変数 errno 
にその原因を示す エラー コードを設定する。 


• ERANGE 展開したファイル名を格納する領域が足りない 

• ENOENT 不正なドライブを指定した 

規 格 —— Project LIBC Group , MS - C 7.0 

関連項目- _ dos _ getassign , _ dos _ nameck , _ fu 丄 lentry 
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ライブラリー第 2 部 


tabs 


用 途—— X の絶対値を返す。 

書 式 # include < math . h > 

double fabs (double x ); 

#include < sys / xmath . h > 
double _ f_fabs (double x ); 
double _ fe_fabs (double x ); 
double _ fpu_fabs (double x ); 

解 説—— fabs 関数はズの値の絶対値を返す。各関数はそれぞれ次のように動作する。 


• fabs 数値演算コプロセッサが使用できる場合は数値演算コブロ 

セッサを直接ドライブし，使用できない場合は FLOAT パッ 
ケージを呼び出す 

• _ f_fabs 数値演算コプロセッサ命令を直接ドライブする 

• _ fe_fabs FLOAT パッケージを呼び出す 

• _ fpu_fabs I / O 数値演算コプロセッサを直接ドライブする 


戻り値——正しく値が求められた場合はその値を返す。もしズが非数 （ NaN ) ならば，変数 
errno にその原因を示すエラーコードを設定して，同じく非数を返す。 

• EDOM I の値が非数 


注 意—— < math . h > を読み込む前に， __ DIRECT _ FLOAT __ が定義されているときは fabs 
は - f e_f abs の別名となり， __ DIRECT _ IOFPU __ が定義されているときは fabs は 
_ fpu _ fabs の別名となる。また， __ DIRECT _ FPU __ が定義されているときは fabs は 
_f _ fabs の別名となる。 

規 格 —— Project LIBC Group，ANSI C ， POSIX . l , XPG 3, AES / OS ，4.3 BSD ， 
SYSV 

関連項目- ceil , floor , fmod 
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fchmod 


用 途——ファイルのアクセスモードを変更する。 

書 式- #include <stat . h > 

mt ichmod ^int fildes , mode_t mode ); 

解 説一 fchmod 関数は， fildes で指定 したファイルハンドルが指すファイルのファイルモー 
ドを mo みで指定する値に変更する0 wo みに指定することができるのは次のとお 
りで，それぞれの値の論理和を指定する。 

• S-IEXEC 実行ファイル，チェンジディレクトリ可能 

• S.IWRITE 書き込み可 

• S.IREAD 読み込み可 



戻り値——正常にアクセスモードの変更ができた場合は〇を返し，失敗した場合は一1を返 
して，変数 errno にその原因を示すエラーコードを設定する。 

• EBADF 不正な fildes を 指定した 

• EPERM ボリュームファイルを変更しようとした 


互換性—— Human 68 k ではファイルに実行属性や読み込み禁止属性を設定することはでき 
ないので（実行属性については execd を使えば可能)， S — IEXEC や S . IREAD は疑似 
的に作り出される値である。 

規 格 —— Project LIBC Group , POSIX . l , XPG 3, AES / OS ，4.3 BSD，SYSV 

関連項目- chmod , fstat , _ mode 2 dos，stat 
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ライブラリー第 2 部 


fchown 


用 途——ファイルのオーナーおよびグルーブを変更する。 

書 式- # include < unistd . h > 

int fchown (int fildes , uid_t owner , gid 一 t group ;; 

解 説 —— f chown 関数は， fildes で指定したファイルハンドルが指すファイルのオーナー ID 

およびグループ ID を変更する。 

戻り値一正常に変更できた場合は0を返し，失敗した場合には 一1 を返して，変数 errno 
にその原因を示すエラーコードを設定する。 

• EBADF 不正な fildes を指定した 

• EL 00 P シンボリックリンクのネストが深すぎるか，またはループしている 

互換性—— Human 68 k にはユーザ ID やグループ ID の概念がないので， fchown 関数がこ 
れらの値に影響されることはない。また， L 仿 C 内ではデフォルトの仮想ユーザ 
ID および仮想グループ ID を root と仮定しているため， fchown 関数は何ら影響 
をおよぼさないとはいえ，変更は必ず成功する。 

規 格—— Project LIBC Group ， POSIX . l , XPG 3, AES / OS , 4.3 BSD , SYSV 

関連項目- chmod , chown , fchmod 
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fclose 


用 途—ファイルストリームをクローズする。 


書 式- #include < stdio . h > 

int fclose (FILE * stream ); 


解 説—— fclose 関数は於/^ w が指すファイルストリームをクローズする。まず fclose 

関数は，バッファリングされていた未書き込みデータをすべて書き出し，読み込 
みデータは捨てる。次に，バッファとして自動的に割り当てられていたメモリを 
解放し，最後にオープンしていたファイルをクローズする。 



戻り値一正常にクローズできた場合は〇を返し，失敗した場合は EOF を返して，変数 errno 
にその原因を示すエラーコードを設定する。 


• EBADF ファイルストリームに関連していたファイルハンドルがおかしい 

• EN 0 SPC デイスタがいっぱいである 


注 意——ューザが setvbuf 関数を用いて割り当てたバッファは自動的には解放されない。 

規 格一 ANSI C , POSIXA , XPG 3, AES / OS ，4.3 BSD , SYSV 

関連項目- close ， fflush , fopen 
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fcloseall 


用 途——すべてのファイルストリームをクローズする。 

書 式- #include <stdio . h > 

int fcloseall ^ void ); 

解 説一 fcloseall 関数は，現在オープンされているすべてのファイルストリームをク 
ローズする。詳細は fclose 関数を参照のこと。 

戻り値——正常にクローズできた場合は0を返し，1つでも失敗した場合は EOF を返して， 
変数 errno にその原因を示すエラーコードを設定する。 

• EBADF ファイルストリームに関連していたファイルハンドルがおかしい 

• ENOSPC ディスクがいっぱいである 

規 格 —— Project LIBC Group，MS-C7.0 
関連項目- fclose , fflush 
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fcntl 


用 途ーファイルとファイルハンドルの操作を行う。 

書 式- #include < fcntl . h > 

mt icntl Lint fildes , int cmd ,...); 

解 説一 fcntl 閨数は打で指定されたファイルハンドルが指すファイルを操作する機 

能を提供する。どういう操作を行うかは cw ゴで指定することができ，以下のコマ 
ンドを指定することができる。 

• FJDUPFD 第3の引数である似ぎを取り出し，似ぎと等しいかそれ以上の番 

号をもつ未使用のファイルハンドルを割り当て，そのファイルハ 
ンドルがガゴ烈の指すファイルと同じファイルを指すようにする。 
新しいファイルハンドルは， flrg 以上のもののうち小さい番号か 
ら順に空いているものが割り当てられる。動作としては dup 2 関 
数と類似している。 

• F_GETFL で指定したファイルハンドルに設定されているファイル 

ステータスフラグ （0_ APPEND ) と，ファイルアクセスフラグ 
rO _ RDONLY , CLWRONLY , 0_ RDWR ) を返す 0 

• F_SETFL で指定したファイルハンドルに設定されているファイルス 

テータスフラグ （0_ APPEND ) を第3の引数である arg で再設定す 
る。ファイルアクセスフラグ （ OJRDONLY ， O . WRONLY , 0_ RDWR ) は 
変化しない。 

戻り値——正常にファイルコントロールできた場合は〇を返し，失敗した場合には_1を返 
して，変数 errno にその原因を示すエラーコードを設定する。 

• EBADF 不正な fildes を 指定した 

• EINVAL 不正な cmd を 指定した 

• EMFILE これ以上ファイルハンドルを割り当てられないか， FJDUPFD で第 

3の引数以上の番号で空いているファイルハンドルがない 

互換性—— fcntl 関数のもつ他の多くの機能，たとえばファイルディスクリプタフラグの取 
得，再設定，ロックの設定，再設定などは省略されている。 

規 格 —— Project LIBC Group，POSIXA、 XPG3, AES/OS， 4.3BSD， SYSV 


関連項目- close , open 
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fcvt 


用 途一浮動小数値を数字列に変換する。 

書 式- # include < stdlib . h > 

char *fcvt (double value , int prec , int * dec,int * sign ); 

解 説一 fcvt 関数は va /收で指定した浮動小数を文字列に変換し，その文字列へのボイ 
ンタを返す。変換は小数点以下の桁数が/^ c 桁になるように行われ，がかには 
の符号が，み c の指す領域には，変換された文字列の何バイト目に小数点が 
くるのかが格納される。つまり，小数点がみ c — 1バイト目とみ c バイト目の間 
にかくされていることになる。 

ただし全体の桁数が/7/*况桁に満たないようならば，足りない分だけ“0” を後ろに 
追加し，桁数が最低でも/桁になるようにする。たとえば，次のような結果を 
返す。 


fcvt 

(+3.14159000, 

3) 

str = 

，3142, 

dec = 

1 

sign = 

0 

fcvt 

(+0.31415900, 

3) 

str = 

, 314 , 

dec = 

0 

sign = 

0 

fcvt 

(-0.03141590, 

3) 

str = 

, 310 , 

dec = 

-1 

sign = 

1 

fcvt 

(-0.00314159, 

3) 

str = 

, 300 , 

dec = 

-2 

sign = 

1 


戻り値——変換した文字列を格納した関数内部の静的領域へのポインタを返す。 

注 意——数値は小数点以下桁目で四捨五入によって丸められる。 

結果は fcvt 関数内部の静的領域に格納されるため， fcvt 関数や ecvt 関数を呼 
び出すたびに内容が上書きされることに注意すること。 

また， printf 関数や sprintf 関数などのフォーマット出力関数は，内部で浮動 
小数を出力する際に fcvt 関数や ecvt 関数を用いているために，静的領域が破壊 
されることがある。 

互換性一本来ならば printf 関数などのように，ライブラリ自体がライブラリ内部の静的 
領域を破壊することは避けなければならないが，現在の仕様では上記のような事 
例が起こり得る。 

規 格 —— Project LIBC Group, XC，MS-C7.0 

関連項目- ecvt , gcvt 
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fdopen 


用 途——ファイルハンドルに対するファイルストリームをオープンする。 

書式- #include < stdio . h > 

FILE *f dopen (mt fildes , const char * mode ); 

解 説一 fdopen 関数は，ガゴ烈で指定したファイルハンドルに対するファイルストリー 
厶をオープンする。 wo みには f open 関数と同様にストリームのモードを指定す 
ることができ，次のなかから1つを選択することができる。ただし， 選択は卿 s 
が指すファイルのオープンモードで許される範囲に限られる。 

• “ r ” 読み込み 

• “ w ” 書き込み 

• “ a ” 追加書き込み 

• “ r +” 更新（読み込みと書き込み） 

• “ w +” 更新（読み込みと書き込み） 

• “ a +” 更新（読み込みと追加書き込み） 

ただし fdopen 関数は f open 関数とは異なり，や “ w +” を指定しても関連す 
るファイルのサイズを0バイトに戻したりはしない。また，モードを表す文字列 
の最後に次の文字を指定することで，ストリームのモードをテキスト/バイナリ 
のどちらかにすることができる。省略時は力/ゴ es が指すファイルのオープンモー 
ドに合わせられる。 

• “ b ” バイナリモード 

• “ t ” テキストモード （CRLF — LF 変換） 

“ r + b ” —バイナリモードでの更新 

戻り値——正常にオープンできた場合はストリームへのポインタを返し，失敗した場合は 
NULL を返して，変数 errno にその原因を示す エラーコー ドを設定する 0 

• EBADF fildes で指定 したファイルハンドルが不正である 

• EMFILE これ以上ファイルストリームを割り当てられない 

• EINVAL mode で不正なモードを指定した 

• EN 0 MEM メモリが足りなくなった 

• EACCES mode で指定したモードは許されない 
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規 格 —— Project LIBC Group ， POSIX.l, XPG3, AES/OS, 4.3BSD，SYSV 


関連項目- fclose , fopen , freopen , open 
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Chapter 1— C 標準関数ライブラリ 


feof 


用 途—ファイルストリームの終端指示子を調べる。 

書 式- #include < stdio . h > 

int feof (FILE * stream ); 

解 説一 feof 関数は於/初 w が指すファイルストリームの終端指示子の状態を調べる。終 

端指示子がセットされるのは，読み込み中にファイルの終端に達した場合である。 

戻り値——ファイルストリームに終端指示子がセットされていれば0以外の値を返し，セッ 
卜されていなければ0を返す。 

規 格—— ANSI C ， P 0 S 1 X .1、 XPG 3, AES / OS ，4.3 BSD , SYSV 

関連項目- clearerr , ferror 
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ライブラリー第 2 部 


terror 


用 途—ファイルストリームのエラー指示子を調べる。 

書 式- #include く stdio . h 〉 

mt ierror (FILE 木 stream ノ； 

解 説- f error 関数は於/^ aw が指すファイルストリームのエラー指示子の状態を調べる 0 

エラー指示子がセットされるのは，対象となるファイルストリームでのデータ入 
出力中に何らかのエラーが発生した場合や，正しい操作を行わずに読み込みから 
書き込みへ，またはその逆の操作を行った場合である。 

戻り値——ファイルストリームに エラー 指示子がセットされていれば0以外の値を，セット 
されていなければ0を返す。 

注 意——ファイルストリームにエラー指示子が設定されている場合，変数 errno にその原 
因を示すエラーコードを設定する。ただし変数 errno の値は，ファイル操作の直 
後しか保証されない。 

規 格一 ANSI C , P 0 SIX .1, XPG 3、 AES / OS ， 4.3 BSD , SYSV 

関連項目- clearerr，feof 
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fflush 


用 途—ファイルストリームをフラッシュする。 


書式- #include < stdio . h > 

int fflush (FILE ^ stream ); 

解 説——打が指すファイルストリームが書き込みモード，あるいは更新モードで最後 
に行った操作が読み込みではなかった場合， fflush 関数はバッファ上に残った未 
書き込みのデータをフラッシュし，実際にデータを出力する。 

stream が指すファイルストリームが読み込みモード，あるいは更新モードで最後 
に行った操作が書き込みではなかった場合， fflush 関数は前回バッファ上から読 
み込んだデータの次にシステムのファイルポインタがくるように補正する。ただ 
しこれは，ファイルストリームに割り付けられたファイルがシーク可能な場合に 
限られる。 



戻り値——正常にフラッシュできた場合は0を返し，失敗した場合は EOF を返して，変数 
errno にその原因を示すエラーコードを設定する。 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

• EN 0 SPC デイスタがいっぱいである 


注 意——ファイルストリームがテキストモードでオープンされている場合，ファイルボイ 

ンタの補正が正しく行われるという保証はない。 

規 格一 Project LIBC Group，ANSI C , POS1X.1 ， XPG3, AES/OS， 4.3BSD, 

SYSV 

関埋項目 close , exit ， fdopen , fopen , fread，fwrite 
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用 途-セットされたビットを検索する。 

式- #include く string . h > 

mt ffs unt bitarray ); 

解 説- ffs 関数はゐ /ramz 少のなかでセットされた最初のビットを見つけ，そのビットの 

桁位置 （インデックス） を返す。ビットは1から数える。 

戻り値- ffs 関数は最初に見つけたビットの桁位置を返す。しかしアが〇で，ビッ 

卜が見つからない場合は0を返す。 

規 格- 4.3BSD 

関連項目- bcmp , bcopy , bzero 
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fgetc 


用 途ーファイルストリームから1バイトを取り出す。 


書 式- #include <stdio.h> 

int fgetc (FILE *stream); 

解 説—— fgetc 関数は，で指定されたファイルストリームから unsigned char 型の 
データとして 1 バイトを取り出し， int 型に変換して返す。ストリームのファイ 
ルポインタはこれに応じて1バイト分進む。 



戻り値——正常に取り出せた場合は，そのデータを返す。もしストリーム操作中に何らかの 
エラーが発生した場合はストリームの エラー 指示子を設定して EOF を返し， ファ 
イルの終端に到達した場合はストリームの終端指示子を設定して EOF を返す。失 
敗した場合は，変数 errno にその原因を示すエラーコードを設定する。 

• EBADF ファイルストリームに関連するフアイルハンドルがおかしい 


規 格一 ANSI C , POSIX . l , XPG 3, AES / OS ，4.3 BSD，SYSV 
関連項目 - getc 
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fgetpos 


用 途——ファイルストリームのファイルボインタの位置を取得する。 

書 式- # include く stdio . h 〉 

int fgetpos (FILE * stream , ipos 一 t * pos ;; 

解 説—— fgetpos 関数は stream で指定されたファイルストリームの現在のファイルポイン 

夕の位置を求め，結果を/? os が指す領域に格納する。この値は， fsetpos 関数を 
用いてファイルポインタの位置を再設定する場合に使用することができる。 

戻り値——正しくファイルポインタの位置を得ることができれば〇を返し，失敗した場合に 
は一1を返して，変数 errno にその原因を示すエラーコードを設定する。 

• ESPIPE ファイルストリームに関連するファイルはシークできない 

注 意ーファイルストリームがテキストモードでオーブンされている場合は， fgetpos 関 
数が正しい値を返す保証はない。同様に， fsetpos 関数で位置を再設定しても元 
の位置に戻る保証はない。 

規 格 —— Project LIBC Group ， ANSI C , POSIXA , XPG 3, AES / OS ，4.3 BSD , 
SYSV 

関埋項目- fopen , fseek , fsetpos , rewind 
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fqets 


用 途——ファイルストリームから文字列を取り出す。 

書式- #include <stdio . h > 

char *fgets (char * s , int n , FILE * streain ); 

解 説一 fgets 関数は於/机 zw で指定されたファイルストリームから文字列を取り出し，結 

果をが指す領域に格納する。文字列の取り出しは《—1バイトを処理するか， 
ファイルの終端に到達するか，改行文字を処理するまで続けられる。結果の文字 
列には改行文字が含まれ，最後に null 文字が置かれることに注意する。 

戻り値一正しく文字列を取り出すことができた場合には S を返す。もしストリーム操作中 
に何らかのエラーが発生した場合は，ストリームの エラー 指示子を設定して NULL 
を返し，ファイルの終端に到達した場合はストリームの終端指示子を設定して 
NULL を返す。失敗した場合は，変数 errno にその原因を示すエラーコードを設 
定する。 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

注 意—— J は少なくとも《バイトの領域を指していなければならない。 

規 格—— ANSI C , POSIX.l、XPG3, AES/OS, 4.3BSD、SYSV 

関連項目- ferror , fread , gets 
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filelenath 


用 途—ファイルの長さを求める。 

書式-# include < unistd . h > 

int filelength (int fildes ); 

解 説 ——f ilelength 関数はガで指定したファイルハンドルが指すファイルの長さを求 
める。 

戻り値——正常に長さを求められた場合はその長さをバイト単位で返し，失敗した場合には 
一 1を返して，変数 errno にその原因を示す エラーコー ドを設定する 0 

• EBADF 不正な fildes を 指定した 

規 格一 Project LIBC Group, XC y MS-C7.0 
関連項目- chsize , fileno，fstat 
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fileno 


用 途——ファイルストリームに関連するファイルハンドルを取得する。 

書 式- #include <stdio . h > 

int fileno (FILE * stream ); 

解 説一 fileno 関数は打/加で指定したファイルストリームに関連するファイルハンド 

ルを返す。 

戻り値——成功した場合はファイルハンドルを返し，失敗した場合は一1を返す。 

規 格一 P 0 SIX .1, XPG 3, AES / OS ，4.3 BSD , SYSV 

関連項目 fdopen，fopen 
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floor 


用 途—— X 以下の整数のなかで最も大きな数を返す。 

書 式- #include < math . h > 

double i 丄〇 or ^aouble x ); 

解 説—— floor 関数は； c 以下の値をもつ整数のなかで最も大きな数を返す 0 

戻り値——正しく値が求められた場合はその値を返す。もし； C が非数 （ NaN ) ならば，変数 
errno にその原因を示すエラーコードを設定して同じく非数を返す。 

• EDOM 1の値が非数，または士 HUGE - VAL だった 

注 意——つねに FLOAT パッケージを呼び出す。 

規 格^一^ Project LIBC Group，ANSI C ， POSIX . l , XPG 3、 AES / OS ， 4.3 BSD , SYSV 

関連項目- ceil 
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flushall 


用 途——すべてのファイルストリームをフラッシュする。 


書 式- #include < stdio . h > 

int flushall ( void ); 


解 説一 flushall 関数は現在オープンされているすべてのフアイルストリームをフラッ 

シュする。詳細は fflush 関数を参照のこと。 



戻り値——正常にフラッシュできた場合は〇を返し，1つでも失敗した場合は EOF を返して， 
変数 errno にその原因を示すエラーコードを設定する 0 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

• EN 0 SPC デイスクがいっぱいである- 


規 格- Project LIBC Group , MS—C 7.0 


関連項目- f flush 
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fmod 


用 途——％の剰余を返す。 


書 式- # include く math . il > 

double fmod〈double x ， double y ); 

# inc 丄 ude < sys / xmath . h > 
double _ f_fmod (double x , double y ); 
double _ fe_fmod (double x , double y ); 
double _ fpu_fmod (double x , double y ); 


解 説—— fmod 関数は％の浮動小数点値の剰余を返す。各関数はそれぞれ次のように動作 

する。 

• fmod 数値演算コプロセッサが使用できる場合は数値演算コブロセッ 

サを直接ドライブし，使用できない場合は FL 0 AT パッケージを 
呼び出す 

• _ f_fmod 数値演算コプロセッサ命令を直接ドライブする 

• _ fe_fmod FLOAT パッケージを呼び出す 

• _ fpu_fmod I/O 数値演算コプロセッサを直接ドライブする 


戻り値——正しく値が求められた場合はその値を返す。もし； c または少が非数 （ NaN ) ならば， 
変数 errno にその原因を示すエラーコードを設定して同じく非数を返す。 


• EDOM JC または夕の値が非数，または少の値が0 


注 意—— Cmath . h 〉 を読み込む前に， __ DIRECT _ FLCDAT __ が定義されているときは fmod 
は- fe _ fmod の別名となり， __ DIRECT _ IOFPU __ が定義されているときは fmod は 
_ fpu _ fmod の別名となる。また， _ JDIRECT _ FPU __ が定義されているときは fmod は 
の別名となる。 

規 格 —— Project LIBC Group、ANSI C ， POSIX . l , XPG 3, AES / OS ，4.3 BSD , 
SYSV 

関連項目- ceil , fabs , floor 
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fmoae 


用 途——ファイルストリームの変換モードを変更する。 

書 式- #include く stdio.h 〉 

void fmode (FILE *stream,int mode); 

解 説—— fmode 関数は对で指定したファイルストリームのテキスト/バイナリ変換 
モードを wo みに変更する。 wc ? みには次の値を指定することができる。 

• .I0TEXT ファイルス トリ ームの変換モー ドをテキストモードに 変更 

する 

• .I0BINARY ファイルス トリ ームの変換モー ドをバイナリモードに 変更 

する 

戻り値一なし。 

規 格- Project LIBC Group , XC 

関連項目 ^- fdopen, fopen, freopen, setmode 
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fopen 


用 途ーファイルストリームをオープンする。 

書 式- #include < stdio . h > 

FILE *fopen (const char * path , const cnar * mode ); 

解 説—— fopen 関数は pa 淡で指定したファイルをオープンし，それに対応するファイルス 

トリー厶を作成する。 mo みにはストリームのモードを指定することができ，次 
のなかから1つを選択することができる。ただし，選択はファイルのファイルア 


クセ スモー 

ドで許される範囲に限られる。 

• “r” 

読み込み 

• V’ 

書き込み 

• “3L” 

追加書き込み 

• “r+” 

更新（読み込みと書き込み） 

• “w+” 

更新（読み込みと書き込み） 

• “a+” 

更新（読み込みと追加書き込み) 


ファイルストリームが“ w ” や“ w +” を指定して書き込み可能な形でオープンした 
場合，すでに/^认で指定したファイルが存在するならばその内容は破棄され，そ 
のサイズは0バイトに切り詰められる。 

また，モードを表す文字列の最後に次の文字を指定することで，ストリームの 
モードをテキスト/ハ•イナリのどちらかにすることができる。省略時はテキスト 
モード，あるいは fmode 関数で指定したモードに合わせられる。 

• “ b ” バイナリモード 

• “ t ” テキストモード （CRLF — LF 変換） 

“ r + b ” — バイナリモードでの更新 

戻り値——正常にオープンできた場合はストリームへのポインタを返し，失敗した場合は 
NULL を返して，変数 errno にその原因を示すエラーコードを設定する。 


• EISDIR ディレクトリである 

• ENOSPC ディスクがいっぱいである 

• ER 0 FS リードオンリーフアイルシステムである 

• EMFILE これ以上ファイルストリームを割り当てられない 

• EINVAL mode で不正なモードを指定した 
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• ENOMEM メモリが足りなくなった 

• EACCES mode で指定したモードは許されない 

規 格 - Project LIBC Group, ANSI C 、 POSIX.l , XPG3 , AES/OS , 

SYSV 

関連項目- fclose , fdopen , freopen , open 


4.3BSD ， 
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fpathconf 


用 途——パス名に関する情報を取り出す。 

書 式- # include < unistd . h > 

long fpathconf (int fildes , int name ;; 

解 説一 fpathconf 関数はガゴ打で指定したファイルハンドルに関連するパスの情報を取 

得し，ユーザアプリケーションに対して現在のシステム設定値などを得る手段を 
与える。どの設定値を調べるかは/^ me で指定する0似 a 狀に指定することがで 
きるマクロ値と求める設定値は次のとおり。 


• _ PC _ LINK_MAX 

• _ PC _ WAX_CANNON 

• _ PC _ MAX_INPUT 

• _ PC _ NAME_MAX 

• _ PC _ PATH_MAX 

• JPCJPIPE_BUF 


ハードリンクの最大値（參考値） 

端末の Canonical 入力の最大バイト数（参考値)〇 
p が/ z は端末デバイスを指していなければならない 
端末の入カキューの最大バイト数（参考値 )。 path 
は端末デバイスを指していなければならない 
ファイル名に許される最大の長さ（ただし mill 文 
字は含まない） 

パス名に許される最大の長さ（ただし null 文字は 
含まない） 

パイプバッファの最大バイト数では疑似パ 
イプしかサポートしていないので，参考値にすぎ 


ない） 

• _ PC _ CHOWN_RESTRICTED chown 閨数の使用が制限されているかどうか 


( ZJBC では chown 関数が必ず成功するので無制限） 

• _ PC _ NO_TRUNC MME _ MAX よりも長いファイル名を，適正な長さま 

で切り詰めるかどうか（ム历(7では一切考慮してい 
ないので，切り詰めはない） 

• _ PC_VDISABLE 端末の特殊文字を無効にすることができる文字（参 

考値)。パ认は端末デバイスを指していなければ 
ならない 


戻り値——正常に制限値を取得できた場合はその値（無制限ならば一 1) を返し，失敗した場 
合には一1を返して，変数 errno にその原因を示すエラーコードを設定する。 

• EINVAL 不正な mzwe を指定したか，または name に_する制限値が求め 

られない 

• EBADF 不正なファイルハンドルを指定した 


106 







Chapterl — C 標準関数ライブラリ 


• ELOOP シンボリックリンクのネストが深すぎるか，またはループして 
いる 

互換性一では上記（詳細は 〈 limits . h > を参照）の制限値は可変ではなく，すべて固 
定である。 

規 格—— POSIX . l , XPG 3 , AES / OS , SYSV 
関連項目- pathconf , sysconf 
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fprintf 


用 途—指定したファイルストリームにフォーマット出力を行う。 

書式-# include <stdio . h > 

mt fprintf (FILE ^ stream , const char * format , …）； 

解 説—— fprintf 関数は， / cm ? がで指定したフォーマット文字列にしたがって引数を文字 

列に変換し，結果を切^ m が指すファイルストリームに出力する。 

/ Mm がに指定するフォーマット文字は通常の文字列であるが，“%”で表される変 
換指定文字に続く一連の変換方法の書式指定があると，その指示にしたがって引 
数が文字列に変換される。これらの変換（たとえば小数点の文字など）は，現在の 
ロ ケールの LC _ NUMERIC カテゴリに左右される。 

通常，変換の書式指定は次のような形式である。 

% [フラグ][最小フィールド幅][精度][変換修飾子][変換指定子] 

1. フラグは任意の命令の変換仕様を修飾するもので，0個以上の任意の数を指 
定することができ，次のようなものがある。 

•-左詰めフラグ 

変換結果をフィールド内部で左詰めする。このフラグを指定しない場 
合は右詰めとなる 

• +符合フラグ 

数値を符合つき変換 （ d ， i , f ， e , E ， g ， G ) した場合，値が正ならば 
頭に“+”を付加し，つねに符合がつくようにする。このフラグを指定 
しない場合は，負の値に限り符合がつく 

• t ，空白フラグ 

数値を符合つき変換 （ d ， i , f ， e ， E ， g ， G ) した場合，値が正ならば 
頭に空白文字を付加し，正負が同じ桁数になるようにする。このフラ 
ダを指定しない場合は，負の値に限り符合がつく。ただし空白フラグと 
符合フラグを同時に指定すると，空白フラグは無視される 

• #表記フラグ 

数値を変換する場合，どのような方法で変換したかがわかるような形 
で処理する。 

- 〇変換の場合，先頭が“ 〇”(8進表記文字）になるように精度を増す 
. x 変換の場合，結果が0以外ならば“ Ox ”（16 進接頭語）を先頭に付加 
する 

• X 変換の場合，結果が0以外ならば“ 0 X ”（16 進接頭語）を先頭に付加 
する 
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- e , E , f , G 変換の場合，つねに小数点を付加する（通常は必要なけ 
れば省かれる） 

• g , G 変換の場合，後続の余分な0を取り除かない（通常は取り除く） 

• それ以外は未定義 

• 00 フラグ 

結果を0詰めする 

- d , i , 〇, u , x , X , e , E , f , g , G 変換の場合，符合や進法表記を 
除くフィールドの先頭部分を “0” で埋める。ただし左詰めフラグと 
0フラグを同時に指定すると，〇フラグは無視される。また， d ， i ， 
〇, u , x , X 変換の場合，精度を指定すると0フラグは無視される 
• それ以外は未定義 

2. 最小フィールド幅には，最小のフィールド幅を指定する10進整数文字列また 
は “*” （アスタリスク）を指定する。変換の結果が指定した最小フィールド幅 
よりも小さければ，文字列は最小フィールド幅の間で右詰め/左詰めされる。 
ただし，最小フィールド幅を指定しなかったり，変換の結果が最小フィール 
ド幅よりも長い場合は何も行わない。もし変換結果の長さを制限したければ， 
精度を利用すること。 

最小フィールド幅に“*”を指定した場合，最小フィールド幅の値は int 型引 
数から取り出される。このとき，もし値が負であれば，フラグ（符合フラ 
ダ）が指定されたとみなし，値が0であれば〇フラダが指定されたとみなす。 

3. 精度には“.”（ピリオド）から始まり，精度を指定する10進整数文字列かまた 
は（アスタリスク）を指定する。精度に“*”を指定した場合，精度の値は 
int 型引数から取り出される。このとき値が負の場合は最小フィールド幅と 
は異なり，単に無視される。 

精度は変換指定子によって意味が異なり，もし精度を指定しなかった場合は 
それぞれの変換指定子に固有の既定値が取られる。 

- d , i , 〇, u , x , X 変換の場合，精度は出現すべき最小の桁数を意味する 
(既定値は 1) 

• e , E , f 変換の場合，精度は小数点の後に出現すべき桁数を意味する（既 
定値は 6 ) 

• g , G 変換の場合，精度は最大有効桁数を意味する（既定値は 6) 

. s 変換の場合，精度は文字列から取り出される最大バイト数を意味する（既 
定値は無限大） 

• それ以外は未定義 

4. 変換修飾子は変換指定子を修飾するもので，数値データなどのデータ型（デー 
タサイズ）を指定するためのものである。変換修飾子には，次の3つから0 
個あるいは1個を指定することができる。 



• h short int 型引数 

引数を short int 型に対するものとして扱う 
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• d ， i , 〇， u , x ， X 変換の場合，引数が short int 型であることを示す 
. n 変換の場合，引数が short int * 型であること示す 
. その他は未定義 


• 1 double 型引数と long int 型引数 

引数を double 型あるいは long int 型に対するものとして扱う 

- d , i , 〇, u , x , X 変換の場合，弓|数が10 ng int 型であることを示す 
- e , E , f , g , G 変換の場合，引数 double 型であることを示す 
. n 変換の場合，引数が 10 ng int * 型であること示す 
. その他は未定義 

• L long double 型引数と long long int 型引数 

引数を 10 ng double 型あるいは long long int 型に対するものとして 
扱う 

- d , i , 〇, u , x , X 変換の場合，引数が10 ng long int 型であること 
を示す 


- e , E , f , g , G 変換の場合，引数10 ng double 型であることを示す 
.n 変換の場合，引数が 10 ng long int * 型であること示す 
• その他は未定義 

変換指定子は実際にどういう変換を行うかを指定するもので，必ず1個は指 
定しなくてはならない。変換指定子には次のようなものがある。 

• d , i 整数型引数を符号つき10進数の文字列に変換する 

• 〇 整数型引数を符号なし8進数の文字列に変換する 

• x 整数型引数を符号なし16進数の文字列 （アルファべ ット部分 

は abcdef ) に変換する 

•X 整数型引数を符号なし16進数の文字列 （アルファべ ット部分 

は ABCDEF ) に変換する 

• f 実数型引数を符号つき10進浮動小数の文字列に変換する 

• e , E 実数型引数を符号つきで，正規化された指数形式の10進浮動小 

数文字列に変換する。指数部の表現は e (あるいは E ) に符号1文 
字，そして最低2桁の指数を伴う 

• g , G 実数型引数を符号つきで， f あるいは e，E と同じ形式に変換す 

る。しかし小数点は必要がなければ出力されない点，小数点以下 
の末尾の連続した0が省かれる点，実際の桁数が最大有効桁数 
より多い場合は最後に丸められた1桁が付加される点が異なる。 
通常は f 形式が選択されるが，指数が 一 5以下か精度以上の場合 
はも E ( g ならば e ， G なら E ) 形式に切り替わる 

• c int 型引数を unsigned char 型に型変換し，それを文字として 

出力する 
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• s char * 型引数を文字列として出力する 

• p void * 型引数をポインタを表現する形式に変換する 

• n 整数型へのボインタ引数か It す領域に，ここまでに出力したパ 

イト数を格納する 

• 7. %文字そのものを出力する 


戻り値——正常に出力できた場合は出力した文字数を返し，失敗した場合は EOF を返して， 
ストリームのエラー指示子を設定する。失敗した場合は変数 errno にその原因を 
示す エラー コードを設定する。 

• EBADF ファイルストリームに関連するフアイルハンドルがおかしい 



注 意—— / orm がで指定したフォーマット文字のなかで使用される変換指示と，実際に 

fprintf 関数に渡した引数の数やデータ型が異なっていたり，ずれていたりした 
場合，その動作は未定義である。たとえば， ％ c の変換指示は int 型の引数をと 
るが，これに char 型のデータを渡した壤合，どのような値が表示されるかにつ 
いては未定義である。 

互換性一 UBC は C ロケールしかサポートしていない。 

規 格 —— Project LIBC Group, ANSI C, POSIX.l, XPG3, AES/OS, 4.3BSD, 

SYSV 


関連項目- eprintf , printf，sprintf 


in 
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fputc 


用 途——ファイルストリームにバイトデータを出力する。 

書 式-# include <stdio . h > 

mt fputc (mt c , FILE * stream ); 

解 説一 fputc 関数は，州で指定されたファイルストリームに対して文字ごを 

unsigned char 型に変換したデータとして出力する。これに応じてストリー 
ムのファイルポインタは1バイト分進む。なお，ストリームが追加モードでオー 
プンされている場合，出力はすべてファイルの最後尾に追加される形で行われる。 

戻り値——正常に出力できた場合は c を返し，何らかのエラーによって失敗した場合は，ス 
トリームのエラー指示子を設定して EOF を返す。失敗した場合は，変数 errno に 
その原因を示すエラーコードを設定する。 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

• EN 0 SPC ディスクがいっぱいである 

規 格 —— ANSI C , POSIX . l ， XPG 3, AES / OS ， 4.3 BSD，SYSV 

関連項目- ferror , fopen , putc , puts 
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fputs 


用 途ーファイルストリームに文字列を出力する。 

書 式- #include <stdio.h> 

int fputs (const char *s, FILE *stream); 

解 説一 fputs 関数は，打/^ 0W で指定されたファイルストリームに対して J が指す文字列 
を出力する。文字列は null 文字までとし，最後の null 文字は出力しない。なお， 
スト リームが 追加 モー ドでオープンされている場合，出力はすべてファイ ルの 最 
後尾に追加される形で行われる。 

戻り値——正常に出力できた場合は負ではない値を返し，失敗した場合は EOF を返してスト 
リームの エラー指示子を設定する。失敗した場合は，変数 errno に その 原因を 示 
す エラーコード を設定する。 

• EBADF ファイルス トリ ームに 関連す るファイルハンドルがおかしい 

規 格 —— ANSI C ， POSIX . l , XPG 3、 AES / OS , 4.3 BSD，SYSV 

関連項目- ferror, fopen, putc, puts 


113 







ライブラリー第 2 部 


fread 


用 途—ファイルストリームからデータ列を取り込む。 

書 式- # include <stdio . h > 

int fread (void * ptr , size_t size , size_t n , FILE * stream ); 

解 説 —— fread 関数は，打/で指定したファイルストリームから 1 項目がバイトの 

データ列を《項目分取り込み，結果を/7びが指す領域に格納する。それに応じて 
ストリームのファイルポインタは，取り込んだバイト数分だけ進む。 

戻り値一実際に取り込んだ項目数を返す。取り込み中にファイルの終端に到達した場合は 
ストリームの終端指示子を設定し，何らかのエラーによって取り込みに失敗した 
場合はストリームのエラー指示子を設定する。 

項目のサイズあるいは項目数《に0が設定された場合， fread 関数は0を返 
し，実際には何も行わない。 

注 意——ファイルの途中で終端に達したり，エラーが発生した場合，ファイルポインタが 

どれだけ進むかは未定義である。また項目の途中で中断した場合には，その項目 
のデータは保証されない。 

規 格 —— ANSI C ， POSIX . l , XPG 3, AES / OS , 4.3 BSD，SYSV 

関連項目- feof ， ferror , fopen ， getc , gets 
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free 


用 途——メモリブロックを解放する。 

書 式- #include < stdlib . h > 

void free 、void * ptr ); 

解 説一 free 関数は 〆 r が指すメモリ領域を解放し，ヒープ領域に返却する。 

戻り値——なし。 

注 意- Zy / BC * では free 関数でメモリ領域をヒープ領域に返却しても，いったん拡張され 

たヒープ領域のサイズは小さくはならない。したがって，現在実行中のプロセス 
が占めるトータルのメモリサイズは変化しない。 

なお， ptr に malloc 関数， calloc 関数や realloc 関数で確保したメモリ領域へ 
のボインタ以外を指定した場合の動作は未定である。 

規 格—— ANSI C , POSIX .1、 XPG 3、 AES / OS ，4.3 BSD , SYSV 

関連項目—— brk , calloc , malloc , rbrk , realloc , sbrk 

変 更一従来ではびに NULL ポインタが指定された場合エラーとなっていたが，現在の 

ではの規定通り何もしないようにした。 



115 





ライブラリー第 2 部 


freopen 


用 途——ファイルストリームを再オープンする。 

書 式- # include <stdio . h > 

FILE *freopen (const char * path , const char * mode , FILE * stream ); 

解 説—— freopen 関数は，まず打/*⑽ m で指定されたファイルストリームをクローズする 0 
次に/?が/ z で指定したファイルをオープンし，対応するファイルストリ.ームを新た 
に打/^ 7 W に割り付ける。 m 供^にはストリームのモードを指定することができ， 
次のなかから1つを選択することができる。ただし，選択はファイルのファイル 
アクセスモー ドで許される範囲に限られる。 


• “ r ” 読み込み 

• ‘ V ’ 書き込み 

• “ a ” 追加書き込み 

• “ r +” 更新（読み込みと書き込み） 

• “ w +” 更新（読み込みと書き込み） 

• “ a +” 更新（読み込みと追加書き込み） 

ファイルストリームが“ w ” や“ を指定して書き込み可能な形でオープンした 
場合，すでに/^ A で指定したファイルが存在するならばその内容は破棄され，そ 
のサイズは0バイトに切り詰められる。 

また，モードを表す文字列の最後に次の文字を指定することで，ストリームの 
モードをテキスト/バイナリのどちらかにすることができる。省略時はテキスト 
モード，あるいは fmode 関数で指定したモードに合わせられる。 

• “ b ” バイナリモード 

• “ t ” テキストモード （CRLF — LF 変換） 


“ r+b ” — バイナリモードでの更新 


戻り値——正常にオープンできた場合はストリームへのポインタを返し，失敗した場合は 
NULL を返して，変数 errno にその原因を示すエラーコードを設定する。 


• EISDIR ディレクトリである 

• EN 0 SPC ディスクがいっぱいである 

• EROFS リードオンリーフアイルシステムである 

• EMFILE これ以上ファイルストリームを割り当てられない 
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• EINVAL mode で不正なモードを指定した 

• ENOMEM メモリが足りなくなった 

• EACCES mode で指定したモードは許されない 

規 格 —— ANSI C , POSIX . l , XPG 3, AES / OS , 4.3 BSD , 

関連項目- fclose , fdopen ， fopen , open 


SYSV 
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frexp 


用 途——浮動小数点値を仮数部と指数部に分ける。 

書 式- #include < math . h > 

double frexp 、 double x , int * exp ); 

解 説—— frexp 関数は， x を正規化して小数部と2の累乗を表す整数の指数部に分解し， 
整数の指数はの cp が指す領域に格納する。仮数部には，0もしくは％ < 1の 

範囲内の数が返される。 

戻り値一正しく値が求められた場合は仮数部の値を返す。もし； c が非数 （ NaN ) または無限 
大だった場合は，変数 errno にその原因を示すエラーコードを設定して同じく非 
数を返す。 

• EDOM ズの値が非数，または無限大 

注 意 —— つねにソフトウエアエミュレートする。 

規 格 —— Project UBC Group，ANSI C , POSIX . l ， XPG 3, AES / OS , 4.3 BSD 、 

SYSV 

関連項目- ldexp , modf 
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fscanf 


用 途一指定したファイルストリームからフォーマツト入力を行う。 


書 式- #include <stdio . h > 

int fscanf (FILE * stream , const char * iormat , •••); 

解 説—— fscanf 関数は/がで指定した入カフォーマツト文字列にしたがって，必要な 

データ列を打/初 w が指すファイルストリームから入力し，その結果を引数の指す 
領域に格納する。 

がに指定するフォーマツト文字は通常の文字列であるが， “ r で表される変 
換指定文字に続く一連の変換方法の書式指定があれば，その指示にしたがって文 
字列がデータに変換される。これらの変換（たとえば小数点の文字など）は，現在 
のロケールの LCJJUMERIC カテゴリに左右される。 

フォーマット文字に含まれるこれらの変換指定文字以外の部分は，次のように処 
理される。 



1. 空白文字 

ストリームからデータを入力し，そのデータが空白文字であるかぎり，それ 
らをすべて読み捨てる 

2. 普通の文字 

ストリームからデータを入力し，そのデータが指定した文字と一致すればよ 
し，一致しなければそこで fscanf 関数の処理を中断する 

通常，変換の書式指定は次のような形式である。 

%[代入抑制文字 （*)] [最大フィールド幅][変換修飾子][変換指定子] 

1. 代入抑制文字として“*”（アスタリスク）を指定すると，変換は行われるが， 
実際に値が代入されることはない。特定の入力を無視したい場合に使用する 

2. 最大フィールド幅には，最大のフィールド幅を指定する10進整数文字列を 
指定する。入力されたデータは最大フィールド幅までの範囲で変換される 

3. 変換修飾子は変換指定子を修飾するもので，数値データなどのデータ型（デー 
タサイズ）を指定するためのものである。変換修飾子には，次の3つから0 
個あるいは1個を指定することができる 

• h short int 型引数 

引数を short int 型に対するものとして扱う 

. d ， i ， n 変換の場合，引数が short int * 型であることを示す 
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• o , n , x , X 変換の場合，引数が unsigned short int * 型である 
ことを示す 
. その他は未定義 

• 1 double 型引数と long int 型引数 

引数を double 型あるいは long int 型に対するものとして扱う 

. d , i , n 変換の場合，引数が long int * 型であることを示す 
. 〇， u ， X ， X 変換の場合，引数が unsigned long int * 型であるこ 

とを示す 

- e , E , f , g , G 変換の場合，引数 double * 型であることを示す 
. その他は未定義 

• L long double 型引数と long long int 型引数 

引数を long double 型あるいは long 10 ng int 型に対するものとし 
て扱う 

- d , i , n 変換の場合，弓|数が 10 ng long int * 型であることを示す 
. 〇， u , x , X 変換の場合，引数が unsigned long long int * 型で 
あることを示す 

- e , E , f , g , G 変換の場合，引数10 ng double * 型であることを 
示す 

. その他は未定義 

変換指定子は実際にどういう変換を行うかを指定するもので，必ず1個は指 
定しなくてはならない。変換指定子には次のようなものがある 

• d 符合つき10進整数を整数型に変換し，格納する。符合つ 

き1◦進整数には先頭の符合は含むが，接尾語の II ， U ， 1， 
L は含まない。 strtol 関数に基数として10を与えた場合 
と同じである 

• i 符合つき8，10，16進整数を整数型に変換し，格納する。 

符合つき8，10，16進整数には先頭の符合を含むが，接尾 
語の u ， U , 1， L は含まない。 strtol 関数に基数として0 
を与えた場合と同じで，数値の基数は文字列の特徴から判 
別される。たとえば，接頭語として“0” があれば8進数， 
“ Ox ” や “0 X ” があれば16進数である 

• 〇 符合つき8進整数を整数型に変換し，格納する。符合つき 

8進整数には先頭の符合は含むが，接尾語の11， U ， 1，しは 
含まない。 strtol 関数に基数として8を与えた場合と同 
じである 

• u 符合なし10進整数を整数型に変換し，格納する。符合な 

し10進整数には先頭の正 （+) 符合は含むが，負 （_) 符合 
や接尾語の U ， U ， 1， L は含まない。 strtoul 関数に基数 
として10を与えた場合と同じである 
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• x,X 符合なし16進整数を整数型に変換し，格納する。符合な 

し16進整数には先頭の正 （+) 符合および接頭語の “ Ox ” や 
“ OX ” （なくてもよい）を含むが，負 （_) 符合や接尾語の U ， 
U , 1, L は含まない。変換^ 1 定子の x , X はどちらも同じで 
あり，大文字子文字の関係はない。 strtoul 関数に基数と 
して16を与えた場合と同じである 

• f 符合つき10進浮動小数を実数型に変換し，格納する。符 

合つき10進浮動小数は fprintf 関数の変換指定子 e ， E ， 
f , g , G のいずれの形式でもよく， strtod 関数による変換 
と同じである。 

• s 空白以外の文字列と一致し，その文字列を格納する 

• [文字の並び] “[” と“]”によって囲まれた文字の集合に「含まれる」文 
字群によって構成される文字列と一致し，その文字列を格 
納する。集合に“]”を指定したい場合は“[”の直後に指定 
すること。その場合，最初の“]”は集合の終わりとはみな 
されない 

• じ文字の並び]“[”と“]”によって囲まれた文字の集合に「含まれない」 
文字群によって構成される文字列と一致し，その文字列を 
格納する。集合に“]”を指定したい場合は“…’の直後に指 
定すること。その場合，最初の“]”は集合の終わりとはみ 
なされない 

• c 任意の1文字に一致し，その文字を int 型に変換して格納 

する 

• p ポインタを表す文字列 ( fprintf 関数の p 変換を参照）を 

void * 型に変換して格納する 

• n ここまでに読み込まれたバイト数を格納する。入力は行わ 

れない 

• % %文字と一致する。通常の文字処理と同じ 

戻り値——正常に入力できた場合は実際に入力できた項目数を返し，失敗した場合は EOF を 
返して，ストリームのエラー指示子を設定する。失敗した場合は変数 errno にそ 
の 原因を示す エラーコー ドを設定する。 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

注 意一引数に指定するボインタは，結果を格納するための十分な大きさの領域を指して 

いなければならない。 

また，加で指定したフォーマット文字のなかで使用される変換指示と，実際 
に fscanf 関数に渡した引数の数やデータ型が異なっていたり，ずれていたりし 
た場合，その動作は未定義である。 
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互換性——は C ロケールしかサポートしていない。 

規 格 —— Project LIBC Group , ANSI C , POSIX . l , XPG 3, AES / OS , 

SYSV 

関連項目- scanf，sscanf 


4.3 BSD ， 
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fseek 


用 途—ファイルストリームのフアイルポインタの位置を再設定する。 


書 式- #include < stdio . h > 

int iseek (FILE ^ stream , long oftset,int wnence ); 

解 説—— fseek 関数は，的 aw で指定したファイルストリームのファイルポインタの位置 

を再設定する。新しい位置は Wz ⑼ ce で指定された開始位置に， offset パべ 卜分の 
オフセットを加算したものとなる。は次のマクロ値をとり，それぞれ開始 
位置を次のように定義する。 

• SEEK_SET ファイルの先頭から計算する 

• SEEK.CUR 現在のファイルポインタの位置から計算する 

• SEEK_END ファイルの終端から計算する 

fseek 関数を実行すると，バッファに残っている未書き込みデータはフラッシュ 
され，未読み込みデータは捨てられる。また，ストリームに設定されていた終端 
指示子はクリアされる。 

fseek 関数はファイルの先頭を越えることはできないが，終端を越えてファイル 
サイズを拡張することはできる。この場合，拡張された部分はすべて〇で埋めら 
れる。 

戻り値一正常にシークできた場合は0を返し，失敗した場合は一1を返して，変数 errno 
に その 原因を示す エラー コードを設定する。 



• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

• EN 0 SPC ディスクがいっぱいである 

• ESPIPE ファイルストリームに関連するファイルはシークできない 

• EINVAL 不正なオフセットをネ旨定した 

互換性——ファイルストリームがテキストモードでオープンされている場合， ftell 関数が 
正しい値を返す保証はない。したがって，その値を用いてシークしても望む位置 
にシークで きるかどうかは未定義である。 

規 格 —— ANSI C , P 0 SIX .1, XPG 3, AES / OS , 4.3 BSD , SYSV 

関連項目- fopen , ftell , rewind 
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fsetpos 


用 途ーファイルストリ ームの ファイルボインタの位置を元に戻す。 

書 式- # include <stdio . h > 

int fsetpos (FILE * stream , const fpos_t * pos ); 

解 説—— fsetpos 関数は，打 ream で指定したファイルストリームのファイルポインタの位 

置を pas が指す領域から取り出して再設定する。 

fsetpos 関数を実行すると，バッファに残っている未書き込みデータはフラッシュ 
され，未読み込みデータは捨てられる。また，ストリームに設定されていた終端 
指示子がクリアされる。 

戻り値——正常に位置を再設定できた場合は0を返し，失敗した場合は一1を返して，変数 
errno にその原因を示す エラーコード を設定する。 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

• EN 0 SPC ディスクがいっぱいである 

• ESPIPE ファイルストリームに関連するファイルはシークできない 

• EINVAL 不正なオフセットを指*定した 

注 意一/ 70 S の指す領域は，あらかじめ fgetpos 関数によって初期化されている必要が 

ある。 


互換性-ファイルストリームがテキストモードでオープンされている場合， fgetpos 関 

数が正しい値を返すという保証はない。したがって，その値を用いてファイルポ 
インタの位置を再設定しようとしても，望む位置に設定されるかどうかは未定義 
である。 

規 格 —— ANSI C 、 P 0 SIX .1, XPG 3、 AES / OS , 4.3 BSD，SYSV 
関連項目- fgetpos , fopen ， fseek , rewind 
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ftell 


用 途——ファイルストリームのファイルポインタの位置を取得する。 


書 式- #include < stdio . h > 

long ftell (FILE * stream ); 

解 説—— ftell 関数は，打/抓 w で指定されたファイルストリームのファイルポインタの位 

置を返す。 

戻り値一正常にファイルポインタの位置を取得できた場合にはその位置（ファイルの先頭 
からのオフセット）を返し，失敗した場合には一1を返して，変数 erxno にその 
原因を示すエラーコードを設定する。 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

• EN 0 SPC ディスクがいっぱいである 

• ESPIPE ファイルストリームに関連するフアイルはシークできない 



互換性——ファイルストリームがテキストモードでオープンされている場合，内部で CRLF — 
LF 変換が行われるため， ftell 関数が正しい値を返すという保証はない 。 ftell 
関数がテキストモードでも正しい値を返すのは，バッファにデータが残っていな 
いとき，すなわちオープン/フラッシュ/シークされた直後だけである。 

規 格 —— ANSI C, POS1XA 、 XPG3, AES/OS ， 4.3BSD, SYSV 

関連項目- fopen , fseek 
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用 途-現在の時刻を取得する。 

書 式- # include < sys / timeb . h > 

void ftime (struct timeb * timeptr ); 

解 説—— ftime 関数は現在の地域時間を求め，結果を r /7^/7 かが指す領域に格納する 。 timeb 
構造体は次のとおり。 


struct timeb { 
time_t time; 


/* 1970 年 1 月 1 日から現在までの経過秒数 */ 


unsigned short millitim; /* 経過秒数のミリ秒レベルの値 */ 


short timezone ; 
short dsti 丄 ag; 


/* タイムゾーン（グリニッジから西方向へ数える ）*/ 
/* サマータイムフラグ */ 


戻り値——なし。 


注 意—— LIBC では， timeb 構造体の millitim はつねに0が設定される。 


規 格 —— Project LIBC Group , 4.3 BSD , MS - C 7.0 


関連項目- ctime , localtime , time , tzset 
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Chapter 1— C 標準関数ライブラリ 


ftruncate 


用 途——ファイルの長さを変更する。 


書 式- #include < unistd . h > 

int ftruncate (int fildes ， off_t 丄 eru ; 

解 説 ftr 皿 cate 関数は，•が指すファイルの長さを/^バイトに変更する。もし 

/⑼が現在のファイル長よりも短い場合，その間のデータはすべて捨てられ，反 
対に長い場合はすべて0のデータで埋められる。 

ただし， ftr 皿 cate 関数はキャラクタデバイスに対しては動作しない。また，ファ 
イルは書き込み可能であることが条件となる。 



戻り値一正常に変更できた場合は〇を返し，失敗した場合には_1を返して，変数 errno 
に その 原因を示す エラー コードを設定する。 

• EBADF 不正な fildes を 指定した 

• ER 0 FS リードオンリーフ アイ ルシステムである 


規 格—— AES/OS 

関連項目- chsize ， creat , open , truncate 
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ライブラリー第2部 


fwrite 


用 途—ファイルストリームにデータ列を書き込む。 

書 式- # include <stdio . h > 

int fwrite く void * ptr , size_t size , size_t n , FILE * stream ); 

解 説—— fwrite 関数は打 mzm で指定したファイルストリームに対して，1項目が垃どパ 

イトのデータ列を/^が指す領域から取り出して，《項目分書き込む。それに応じ 
てストリームのファイルポインタは，書き込んだバイト数分だけ進む。なお，ス 
トリームが追加モードでオープンされている場合，出力はすべてファイルの最後 
尾に追加される形で行われる。 

戻り値——実際に書き込んだ項目数を返す。もし，書き込み中に何らかの エラーに よって書 
き込みに失敗した場合，ストリームのエラー指示子を設定する。 

項目のサイズあるいは項目数《に0が設定された場合は， fwrite 関数は0 
を返し，実際には何も行わない。 

注 意ーファイルの途中でエラーが発生した場合に，ファイルボインタがどれだけ進むか， 

すなわち正確に何バイトが書き込まれるかは未定義である。また項目の途中で中 
断した場合には，その項目のデータは保証されない。 

規 格一 ANSI C ， POSIX . l 、 XPG 3, AES / OS ， 4.3 BSD , SYSV 

関連項目- feof ， ferror , fopen , putc , puts 
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_getdriveno 


Chapter 1 一 C 標準関数ライブラリ 


用 途 ファイル名から論理ドフイフ番号を求める。 


書 式- #include < sys / xstdlib . h > 

int .getdriveno ^const char * path ) 

解 説一 - getdriveno 関数は p が/ z で指定したファイル名をフルパスに展開し，求められ 
たパスの論理ドライブ番号を返す。 

戻り値——正常にドライブ番号が求められた場合は論理ドライブ番号を返し，失敗した場合 
は一1を返して，変数 errno にその原因を示すエラーコード設定する。論理ドラ 
イブ番号は A : ドライブを〇とする。 

• EN 0 ENT 不正なドライブを指定した 



注 意—— - getdriveno 関数はライブラリの内部関数なので，移植性を考慮するならば使用 

しないこと。 

規 格- Project LIBC Group 

関連項目- _do s—get as sign ，_ dos _ nameck , _ fullentry , _fullpath 
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ライブラリー第 2 部 


—getleaps 


用 途——指定した年までの閏年の回数を調べる。 

書 式- # include く sys/xtime . h > 

int .getleaps unt year ); 

解 説—— - getleaps 関数は，1970年1月1日 （エポックタイム） からで指定した年 
の前年までに何回閏年があったかを求める。ここで，閏年とは西暦年が4で割り 
切れる年のことである。ただし閏年でも100で割り切れ，400で割り切れない年 
は閏年ではない。 

戻り値——閏年があった回数を返す。 

注 意—— - getleaps 関数はライブラリの内部関数なので，移植性を考慮するならば使用し 
ないこと。 

規 格- Project LIBC Group 

関連項目- -isleap 
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Chapter 1— C 標準関数ライブラリ 


gcvt 


用 途 浮動小数値を G フォーマット形式の文字列に変換する。 


僅 式- #include <stdlib .h> 

char *gcvt ^double value, int prec, char *buff); 


解 説—— gcvt 関数は vfl/we で指定した浮動小数を G フォーマットの文字列に変換し，その 

結果を加ガが指す領域に格納する。変換は，有効桁数が/桁になるように実行 
される。 buff には ，変換の結果として小数点や指数表示が格納されることがある 
ので，/7/■沈桁以上の十分な余裕をもつ必要がある。 

gcvt 関数は，たとえば次のような結果を返す。 



gcvt (31.415900， 3) 
gcvt ( 3.141590, 3) 
gcvt ( 0.314159, 3) 
gcvt ( 0.0314 16, 3) 
gcvt ( 0.0031 42, 3) 


str = , 31.4 , 
str = , 3.14* 
str = , 0.314 , 
str = , 3.14E-002 , 
str = , 3.14E-003 , 


戻り値—— buff を返 ^ 

注 意——数値は， prec +1桁目で四捨五入によって丸められる。 

buff は， 結果を格納するだけの十分な大きさの領域を指していなければならない。 

規 格 —— Project LIBC Group, XC，MS-C7.0 

関連項目- ecvt, fcvt 
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用 途——ファイルストリームから1バイトを取り出す。 

書 式-# include <stdio .h> 

int getc (FILE ^stream); 

解 説- getc 関数は，で指定されたファイルストリームから皿 signed char 型の 

データとして 1 バイトを取り出し， int 型に変換して返す。ストリームのファイ 
ルポインタは，これに応じて 1 バイト分進む。 getc 関数は，皿 getc 関数で押し 
戻されたデータを正しく扱うことができないこと，および更新モードで正しく動 
作しないことを除けば fgetc 関数と同じである。 

戻り値——正常に取り出せた場合は，そのデータを返す。もしストリーム操作中に何らかの 
エラーが発生した場合はストリームの エラー 指示子を設定して EOF を返し， ファ 
イルの終端に到達した場合はストリームの終端指示子を設定して EOF を返す。失 
敗した場合は，変数 errno にその原因を示すエラーコードを設定する 0 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

注 意—— getc 関数は，デフォルトではマクロとして定義されるが， -_N0_STDI0_INLINE__ が 

定義された場合は実体をもつ関数となる。 

getc 関数がマクロとして展開される場合，引数が副作用を伴わないように注意 
すること。 

規 格 —— ANSI C , POSIX . l , XPG 3 , AES / OS , 4 . 3 BSD , SYSV 

関連項目- fgetc 
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Chapter 1— C 標準関数ライブラリ 


getch 


用 途 ー コンソールから直接1文字を入力する（エコーなし)。 

書 式- #include く conio . h 〉 

int getch ( void ); 

解 説—— getch 関数はコンソールから1文字を入力し，その文字コードを返す。ただし入 

力された文字は，コンソールにエコーバックされない。 getch 関数はつねにコン 
ソールから直接データを読み取るので，標準入力の状態に左右されず，また stdio 
ライブラリによるハへソファリングの作用も受けない0 

getch 閨数は1文字を入力するまで待つが，すでにキーボードバッファにデータ 
がある場合や ungetch 関数によって押し戻されたデータがある場合は，それを取 
得する。 

戻り値一入力された文字の文字コードを返す。エラーはない。 

注 意一構造上， 0 x 00 の文字コードは取得することができない。 

規 格一 Project LIBC Group ， MS - C 7.0 

関連項目- getc ， getchar，getche 
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ライブラリー第 2 部 


getchar 


用 途—標準入カファイルストリームから1バイトを取り出す。 

書式- #include <stdio .h> 

int getchar (void); 

解 説- getchar 関数は，標準入力に割り当てられたファイルストリー厶から 

unsigned char 型の データ として 1 バイトを取り出し，それを int 型に変換 
して返す。ストリームのファイルポインタは，これに応じて1バイト分進む。 

getchar 関数は ungetc 関数で押し戻されたデータを正しく扱うことができない 
こと，および更新モードで正しく動作しないことを除けば， fgetc 関数に stdin 
を指定した場合と同じである。 

戻り値——正常に取り出せた場合は，そのデータを返す。もしストリーム操作中に何らかの 
エラーが発生した場合は標準入カストリームの エラー 指示子を設定して EOF を返 
し，ファイルの終端に到達した場合はストリームの終端指示子を設定して EOF を 
返す。失敗した場合は，変数 errno にその原因を示すエラーコードを設定する。 

• EBADF ファイルス トリ ームに 関連する ファイルハンドルがおかしい 

注 意—— getchar 関数はデフォルトではマクロとして定義されるが， __NO_STDIO_INLINE_j^ 

定義された場合は実体をもつ関数となる。 

getchar 関数がマクロとして展開される場合，引数は副作用を伴わないように注 
意すること。 

規 格—— ANSI C , POSIX . l , XPG 3、 AES / OS , 4.3 BSD ， 5757 

関連項目- fgetc, getc 
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getche 


用 途—コンソールから直接1文字を入力する（エコーあり）。 

書 式- #include < conio . h > 

int getche ( void ); 


解 説—— getche 閨数はコンソールから1文字を入力し，その文字コードを返す。 getcli 関 
数とは異なり，入力された文字はコンソールにエコーバックされる。 getche 関 
数はつねにコンソールから直接データを読み取るので，標準入力の状態に左右さ 
れることも stdio ライブラリによるバッファリングの作用も受けない。 

getche 関数は1文字を入力するまで待つが，すでにキーポードバッファにデー 
夕がある場合や皿 getcii 関数によって押し戻されたデータがある場合は，それを 
取得する。 



戻り値——入力された文字の文字コードを返す。エラーはない。 


注 意——構造上， 0 x 00 の文字コードは取得することができない。 


規 格一 Project LIBC Group ， MS — C 7.0 


関連項目- getc ， getch，getchar 
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getcwd 


用 途ーカレントワーキングディレクトリを取得する。 

書 式- #include < unistd . h > 

char *getcwd 、char * buff , int size ); 

解 説—— getcwd 関数は，カレントドライブのカレントワーキングディレクトリのパス名 

を取得し， buff が 針 size バイ トの領域にコピーする。パス名は，すべて先頭に 
ドライブ名を付加した絶対パス名の形で返される。 

“ A :/ foo / bar/samp 丄 e / directorv ” 

戻り値——正常に取得できた場合にはを返し，失敗した場合には NULL を返して，変数 
errno にその原因を示すエラーコードを設定する。 

• EINVAL size が 0または負の値である 

• ERANGE パス名が size バイ トより長い 

規 格—— Project LIBC Group，POSIX.l，XPG3、AES/OS, 4.3BSD, SYSV 

関連項目- chdir , chdrive , getdcwd 

変 更——従来では buff に NULL ボイ ンタが 指定された場合 エラーと なって いたが， 現在の 
L / 份7では getcwd 関数が結果を格納する領域を自動的に割り当てるようにした。 
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Chapter 1— C 標準関数ライブラリ 


getdcwd 


用 途——指定ドライブのカレントワーキングディレクトリを取得する。 


誉式- #mclude < unistd . h > 

char *getdcwd (mt drive , char * buff , int size ); 


解 説一 getdcwd 関数は，ゴ r / ve で指定したドライブのカレントワーキングディレクトリの 

パス名を取得し， buff が狺 t size バイ トの領域にコピーする。ハ。ス名は，ドライ 
ブ名なしの絶対パス名で返される。めは0がカレントドライブ，以降，1が A : 
ドライブ，2が B :ドライブの順番で指定する。 



“ / foo / bar / baz ” 


戻り値——正常に取得できた場合には^#を返し，失敗した場合には NULL を返して，変数 
errno にその原因を示すエラーコードを設定する。 


• EINVAL size が0または負の値である 

• ERANGE パス名がバイトより長い 


規 格- Project LIBC Group ， MS-C7.0 

関連項目- chdir , chdrive , getcwd 

変 更——従来では buff に NULL ボインタが指定された場合 エラーと なっていたが，現在 

のでは getdcwd 関数が結果を格納する領域を自動的に割り当てるように 
した。 
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getdrive 


用 途——カレントドライブを取得する。 

書 式- #include < unistd . h > 

int getdrive 、 void ); 

解 説—— getdrive 関数はカレントドライブを取得する。 

戻り値—— getdrive 関数はカレントドライブを返す。エラーはない。ドライブ番号は A : ド 
ライブを1とし，以降，2が B : ドライブ，3が C : ドライブの順番に割り振られる。 

規 格 —— Project LIBC Group, MS-C7.0 

関連項目- chdir , chdrive ， getcwd , getdcwd 
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Chapter 1— C 標準関数ライブラリ 


geteqid 


用 途一実効グループ ID を取得する。 

書 式- #include < unistd . h > 

gid_t getegid ( void ); 

解 説- getegid 関数は，カレントプロセスの実効グループ ID を返す。 

戻り値-実効グループ ID を返す。 

互換性一 Human 68 k にはグループ ID の概念がない。そのため getegid 関数では，環境 
変数 EGID の値を実効グループ ID とする。しかし，失敗した場合は getgid 関 
数の戻り値を実効グループ ID とする。 

規 格 —— Project LIBC Group, POSIX.l, XPG3, AES/OS, 4.3BSD, SYSV 

関連項目- getgid , setgid 
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getenv 


用 途——環境変数の値を取得する。 

書 式- #include く stdlib . h 〉 

char *getenv (const char * name ); 

解 説一 getenv 関数はプロセスの環境変数テーブルを検索し，で指定された環境変 

数の値を取得する。 

戻り値一正常に取得できた場合は環境変数の値（文字列）へのポインタを返し，失敗した場 
合には NULL を返す。 

注 意ーアプリケーションは取得されたボインタの指す領域を変更してはならない。 

検索される環境変数テーブルはプロセス内部にコピーされた環境変数テーブルで 
あり，親プロセスの環境変数テーブルや Human 68 k の環境変数テーブルでは 
ない0 

規 格 —— Project LIBC Group，P0SIX.1, XPG3, AES/OS, 4.3BSD, SYSV 

関連項目- clearenv ， environ，putenv 
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Chapter 1— C 標準関数ライプラリ 


geteuid 


用 途-実効 ユーザ ID を取得する。 

書式- #include < unistd . h > 

uid_t geteuid ( void ); 


解 説- geteuid 関数はカレントプロセスの実効ユーザ ID を返す。 

戻り値——実効 ユーザ ID を返す。 

互換性—— Human 68 k にはユーザ ID の概念がない。そのため geteuid 関数では，環境変 
数 EUID の値を実効 ユーザ ID とする。しかし，失敗した場合は getuid 関数の戻 
り値を実効 ユーザ ID とする。 



規 格 —— Project LIBC Group, P0SIX.1, XPG3, AES/OS t 4.3BSD， SYSV 


関連項目- getuid , setuid 
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ライブラリー第 2 部 


getgid 


用 途-実グループ ID を取得する。 

書 式-# include < unistd . h > 

gid_t getgid ( void ); 

解 説 —— getgid 閨数はカレントプロセスの実グループ ID を返す。 

戻り値一実グループ ID を返す。 

互換性—— Human 68 k にはグループ ID の概念がない。そのため getgid 関数では，環境 
変数 GID の値を実グループ ID とする。しかし，失敗した場合は0 ( root ) を実グ 
ループ ID とする。 

規 格 —— Project LIBC Group, P0SIX.1, XPG3, AES/OS, 4.3BSD、SYSV 

関連項目一 getegid , setgid 
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Chapter 1 一 C 標準関数ライブラリ 


getqrent 


用 途 —— グループファイルから 1 データを 取り出す。 


書 式 - #include <grp. h> 

struct group *getgrent (void); 


解 説- getgrent 関数は，呼び出されるごとにグループファイルから 1 グループデータ 

を取り出して， そのグルーブデータへの ポインタを返す。 グルーブファイルは 最 
初の getgrent 関数か setgrent 関数の呼び出しで才ープンされ， endgrent 関 
数でクローズされるまで連続して利用される。 

読み出されたグループデータはフォーマット处理され， getgrent 関数内部の静 
的領域に格納される。 group 構造体で表されるグループデータの構造は次のと 
おり0 



struct group て 

char *gr_name ; 
char *gr_passwd; 
gid_t gr.gid; 
char **gr_mem; 

>； 


/* グループ名 */ 

/* グループパスワード */ 

/* グループ ID */ 

/* グルーブメンバの配列 */ 


グループファイルは固定的に “A:/etc/group” が用いられるが，環境変数 SYSR00T 
によってこれらのファイルのルートディレクトリを変更することもできる。たと 
えば， SYSR00T に“ B:/root” が設定されている場合，グループファイルのパス 
名は “B:/root/etc/group” となる。 


戻り値一正常にデータを取り出せた場合は，グループデータへのポインタを返す。すべて 
のデータを読み終わったり，グループファイルをオープンできないなど何らかの 
原因で失敗した場合は NULL を返して，変数 errno にその原因を示すエラーコー 
ドを設定する。 


• EMFILE これ以上ファイルをオープンできない 

• EN0ENT グループファイルが見つからない 

• EN0MEM メモリが足りなくなった 

注 意——結果は関数内部の静的領域に格納されるため， getgrent 関数， getgrnam 関数， 

getgrgid 関数のいずれかの関数を呼び出すたびに，内容が上書きされることに 
注意すること。 


143 






ライブラリー第 2 部 


互換性-グループフアイルのフアイルフォーマットは，各項目間のセノマレータに‘：’では 

なくて 4 ;’ を用いている以外は UNIX と同じである。 

規 格 —— Project LIBC Group , 4.3 BSD，SYSV 

関埋項目- endgrent , getgrgid , getgrnam , setgrent 
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Chapter 1— C 標準関数ライブラリ 


getgrgid 


用 途ーグループファイルからグループ ID でデータを検索する。 


書 式- #include < grp . h > 

struct group 本 getgrgid ( gid_t gid ); 


解 説一 getgrgid 関数は，グループファイルからが•ゴで指定したグループ ID のデータを 

検索し，そのグループデータへのポインタを返す。グループファイルは検索終了 
後に自動的にクローズされるので， endgrent 関数を呼び出す必要はない。 

group 構造体の構造など，詳細は getgrent 関数を参照のこと。 



戻り値一該当するデータを見つけることができた場合はグループデータへのポインタを返 
し，見つからなかったか，グルーブファイルをオーブンできないなど何らかの原 
因で失敗した場合は NULL を返して，変数 errno にその原因を示すエラーコード 
を設定する。 

• EMFILE これ以上ファイルをオープンできない 

• EN 0 ENT グループファイルが見つからない 

• EN 0 MEM メモリが足りなくなった 


注 意——結果は関数内部の静的領域に格納されるため， getgrent 関数， getgrnam 関数， 

getgrgid 関数のいずれかの関数を呼び出すたびに，内容が上書きされることに 
注意すること。 

規 格 —— Project LIBC Group ， POSIX . l , XPG 3, AES / OS ， 4.3 BSD , SYSV 

関連項目- endgrent , getgrent ， getgrnam , setgrent 
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getgrnam 


用 途—— グループファイ ルから グループ 名で データ を検索する。 

書 式-# include <grp. h> 

struct group *getgrnam (const chax *name); 

解 説 一 getgrnam 関数はグループファイルからで指定した グルーブ 名の データを 

検索し，その グループデータへの ポインタを返す。 グループ ファイルは検索終了 
後に自動的にクローズされるので， endgrent 関数を呼び出す必要はない。 

group 構造体の構造など，詳細は getgrent 関数を参照のこと。 

戻り値一該当するデータを見つけることができた場合はグループデータへのポインタを返 
し，見つからなかったり，グループファイルをオープンできないなど何らかの原 
因で失敗した場合は NULL を返して，変数 errno にその原因を示すエラーコード 
を設定する。 

• EMFILE これ以上ファイルをオープンできない 

• EN0ENT グループファイルが見つからない 

• EN0MEM メモリが足りなくなった 

注 意——結果は関数内部の静的領域に格納されるため， getgrent 関数， getgrnam 関数， 

getgrgid 関数のいずれかの関数を呼び出すたびに，内容が上書きされることに 
注意すること。 

規 格 —— Project LIBC Group ， P 0 SIX .1, XPG 3, AES / OS , 4.3 BSD , SYSV 

関連項目- endgrent, getgrent, getgrgid, setgrent 
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getlogin 


用 途—— ユーザの ログイン名を取得する。 

書 式- #include く皿 istd . li > 

char *getlogin ( void ) ; 

解 説一 getlogin 関数はカレントプロセスの制御端末へのログイン名を調べ，そのログ 
イン名へのポインタを返す。 

戻り値——正常に取得できた場合はログイン名へのポインタを返し，失敗した場合には NULL 
を返す。 

注 意——結果は関数内部の静的領域に格納されるため，関数を呼び出すたびに内容が上書 
きされることに注意すること。 



互換性- Human 68 k は制御端末およびユーザ ID に閨する概念がない。そのため ， getlogin 

関数では ksh ， bash ， fish , minsh などのシェルと同様，環境変数 USER あるい 
は L 0 GNAME からログイン名を取得することにしている。なお，これらの環境変数 
が設定されていない場合は “ root ” を返す。 


規 格—— P 0 SIX .1, XPG 3, AES / OS ，4.3 BSD , 

関連項目- cuserid , getpwnam , getpwuid , getuid 
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getopt 


用 途一引数配列からオプション文字列を解析する。 

書 式 - #include <stdlib.h> 

int getopt (int argc, const char *argv[] , const char *optstrmg); 

extern char *optarg; 

extern int optind; 

extern int opterr; 

extern int _getopt_no_reordering; 

解 説—— getopt 関数は，コマンドラインを解析するためのものである。 getopt 関数は 

a ; •がと argv ヒ で指定されたコマンドラインの引数配列を叩びで指定された 
オプション文字列にしたがって走査する。 

叩びか//後に指定するオプション文字列には，使用することのできるオプション文 
字の一覧を指定する。たとえば，オプションとして “_a” と “-v” を指定できるよ 
うにしたいならば， optstring には “av” と指定する。 

また，これらのオプション文字の直後に“:”をつけることによって，オプション 
が引数を取るということを表すことができる。この場合，オプションの引数は， 

-a u bar 

-abax 

getopt 関数は呼ばれるたびに変数 optirid が指す位置の次の引数を調べ，もしそ 
れが“-”で始まり，かつ叩加 r / zig に指定されているオプション文字であれば，そ 
の文字コードを返す。また同時に，変数 optind に現在の位置を記録し，オプショ 
ンが引数を取るならば変数 optarg にその引数へのボインタを設定する。なおラ 
イブラリは，最初の getopt 関数の呼び出しにさきだって変数 optind を〇にク 
リアする。 

通常， getopt 関数は“-”で始まるオプションを見つけると，に指定さ 
れたオプション文字列と照合する。しかしこれに含まれない，すなわち不正な才 
プション文字を発見したり，引数を必要とするのに引数が指定されていないよう 
な場合には，標準 エラー 出力に エラーメッセージを 出力し，“?”を返す。もし， 
このエラーメッセージを 出力しないようにするには，変数 opterr を 0 に設定す 
る。デフォルトでは1が設定されている。 

getopt 関数は，これ以上オプション文字が見つからないと判断すると EOF を返 
し，変数 optind にオブション文字ではない引数のうちで先頭のものの位置を設 
定する。たとえば， 
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という引数配列があり，これに対して叩加/*/叹に“ ab : ” を設定した場合，最初 
の呼び出しで getopt 関数は“ a ” を返し，2回目の呼び出しでは“ b ” を返すのに 
加えて変数 optarg に “ foo . c ” へのボインタを返す。そして3回目の呼び出しで 
は，これ以上オプション引数がないため EOF を返し，変数 optind に“ bar . c ” の 
インデックスを設定する。 

一般に getopt 関数は引数列を前から解析していき，オプションではない引数を発 
見した段階で処理を中断してしまう （ EOF を返す）が，の getopt 関数は引数 
列全体を走査し，すべてのオプション指定を調べることができる。またその結果， 
引数配列はオプション指定が先頭に，そうではない引数が後ろになるようにソート 
される。もしこうしたソート機能に支障があれば，変数 - getopt _ qo- reordering 
に1を設定する。デフォルトでは0が設定される。 

この機能を詳しく説明しよう。たとえば， 

-a - cfoo.c 一 v foo.c bar.c baz.c -z -t foo.c 



という引数配列に対して optstring {こ 11 在 c : v : zt :”を指定し，ソートが行われる状 
態で getopt 関数を実行してみよう。すると， getopt 関数が EOF を返して捜査が 
終了した段階で，引数列は次のようにソートされ，変数 optind は “ bar . c ” を指 
すことになる。 


-a - cf 〇〇 .c -v foo.c -z -t foo.c bar.c baz.c 


戻り値 —— 有効なオプションを見つけるとそのオプション文字の文字コードを返し，無効な 
オプションを見つけると“?”を返す。また，すべてのオプションの処理が終わる 
と EOF を返し， “一” というオプションを発見すると，特殊な処理として，そこ 
ですベてのオプションが終了したものとして EOF を返す。 


注 意——デフォルト状態では引数配列のソートが行われ，その結果， flrgv の中身が書き換 

えられることがある。 

互換性ーデフォルトで引数配列のソートが行われるため，これが行われないものと 
仮定したうえで書かれたプログラムとは互換性を失う。その場合は，変数 
.getopt _no . reordering を最初の getopt 関数呼び出しの前に0にしておくこと 
が必要となる。 

オプションかどうかを判定するのは，引数の先頭に“-”があるかどうかである。 
Human 68 k や MS - DOS でよく使われる“/”は，パス名との区別ができない 
ためにでは使用していない。 


規 格 一 XPG 3, AES / OS , 4.3 BSD ， SYSV 
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サンプル 



topt 関数の使用例 


1 ： /* 

2 : オプション a , b を解析する 

3: */ 

4: 

5 : # include く stdio.h 〉 

6: #include <stdlib.h> 

7: 

8: int main (int argc, char 本 * argv) 

9: { 

10 : int c; 

11 : 

12: while ((c = getopt (argc, argv, "ab:")) != EOF) { 

13: switch (c) { 

14 : case : 

15: printf ("OPTION A\n"); 

16: break; 

17: case ’b ’： 

18: printf ("OPTION B — %s\n", optarg); 

19: break; 

20 : case ’？’： 

21: default: 

22: printf ("UNKNOWN 0PTI0N\n"); 

23: break; 

24: } 

25: > 

26 : return 0; 

27: > 
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getpgrp 


用 途——プロセスグループ ID を取得する。 

書 式- #include < unistd . h > 

pid_t getpgrp ^ void ); 

解 説—— getpgrp 関数はカレントプロセスのプロセスグループ ID を調べ，その値を返す。 
戻り値——プロセスグループ ID を返す。 

互換性—— Human 68 k はマルチタスクではないので，プロセス ID およびプロセスグルー 
プ ID の概念がない。そのため getpgrp 関数はつねに1 ( init ブロセス）を返す。 

規格—— P 0 SIX .1, XPG 3, AES / OS , 4.3 BSD , SYSV 

関連項目- getpid , getppid ， setpgid , setsid 
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getpia 


用 途ープロセス ID を取得する。 

書 式- # include < unistd . h > 

pid_t getpid ( void ); 

解 説一 getpid 関数はカレントプロセスのプロセス ID を返す。 

戻り値——プロセス ID を返す。 

互換性 一- Human 68 k はマルチタスクではないのでプロセス ID の概念がない。そのため 
getpid 関数では，カレントプロセスのロードアドレス，すなわちメモリ管理ポ 
インタの値をプロセス ID とする。 

UNIX では，プロセス ID は〇〜30000の範囲内に定められているが，メモリ 
管理ポインタの値は24ビットなので範囲を越えてしまう。したがって，この定 
義に忠実にコーディングされているプログラムとは互換性を失う。 

規 格一 Project LIBC Group，POSIX.l, XPG3, AES/OS, 4.3BSD，SYSV 

関連項目- getpgrp , getppid , kill , setsid 
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getppid 


用 途——親プロセス ID を取得する。 

書 式- #include く皿 istd . h 〉 

pid_t getppid ( void ); 

解 説 一 getppid 関数は，カレントプロセスの 親プロセスのプロセス ID を返す。 

戻り値——親プロセス ID を返す。 

互換性—— Human 68 k はマルチタスクではないので，プロセス ID の概念がない。そのた 
め getppid 関数では，親プロセス ID としてカレントプロセスのメモリ管理ボイ 
ンタの親メモリ管理ボインタの値を用いる。 

UNIX では，プロセス ID は〇〜30000の範囲内に定められているが，メモリ 
管理ポインタの値は24ビットなので範囲を越えてしまう。したがって，この定 
義に忠実にコーディングされているプログラムとは互換性を失う。 

規 格 —— Project LIBC Group, POSIX.l, XPG3, AES/OS, 4.3BSD, SYSV 

関連項目- getpgrp , getpid , kill , setsid 
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getpwent 


用 途——パスワードファイルから1データを取り出す。 

•rf 式-# include <pwd. h> 

struct passwd *getpwent (void); 

解 説—— getpwent 関数は呼び出されるごとにパスワードファイルから 1 パスワードデータ 
を取り出して，そのパスワードデータへのポインタを返す。パスワードファイル 
は最初の getpwent 関数か setpwent 関数の呼び出しでオープンされ， endpwent 
関数でクローズされるまで連続して利用される。 

読み出されたパスワードデータはフォー マッ ト処理され， getpwent 関数内部の 
静的領域に格納される。 passwd 構造体で表されるパスワードデータの構造は次 
のとおり。 

struct passwd { 


char 

*pw_name; 

/* 

ユーザ名*/ 

char 

*pw_passwd; 

/* 

パスワード*/ 

uid_t 

pw_uid; 

/* 

ユーザ ID */ 

gid.t 

pw.gid; 

/* 

グループ ID */ 

char 

*pw_gecos; 

/* 

GEC0S フイ ー ルド*/ 

char 

*pw_dir; 

/* 

ホームデイ レクトリ*/ 

char 

*pw_shell; 

/* 

ロ グイ ン シェル*/ 


パスワードファイルは固定的に “A:/etc/passwd” が用いられるが，環境変 
数 SYSR00T によって，これらのファイルのルートデイレクトリを変更することも 
できる。たとえば SYSR00T に“ B:/root” が設定されている場合，パスワードファ 
イルのパス名は “B : /root/etc/passwd” となる。 

戻り値——正常にデータを取り出せた場合はパスワードデータへのポインタを返し，すべ 
てのデータを読み終わったか，パスワードファイルをオープンできないなど何ら 
かの原因で失敗した場合は NULL を返して，変数 errno にその原因を示すエラー 
コードを設定する。 


• EMFILE これ以上ファイルをオープンできない 

• EN0ENT パスワードファイルが見つからない 

• EN0MEM メモリが足りなくなった 

注 意——結果は関数内部の静的領域に格納されるため， getpwent 関数， getpwnam 関数， 

getpwnid 関数のいずれかの関数を呼び出すたびに，内容が上書きされることに 
注意すること。 
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互換性ーパスワードファイルのファイルフォーマットは，各項目間のセパレータが‘：’ 
ではなくて‘；’を用いている以外は UNIX と同じであり ， ITA ToolBox の 
“login .X” が用いているフォーマットに合わせてある。 

規 格 —— Project LIBC Group , 4 . 3 BSD , SYSV 


関連 r 貝白- endpwent, getpwnam, getpwuid, setpwent 




ライブラリー第 2 部 


getpwnam 


用 途——パ スワー ドファイルから ユーザ 名で データを 検索する。 

谱式 - # inc 丄 ude < pwd . h > 

struct passwd *getpwnam uonst char * name ); 

解 説- getpwnam 関数はパスワードファイルからで指定した ユーザ 名のデータを 

検索し，そのパスワードデータへのポインタを返す。パスワードファイルは検索 
終了後に自動的にクローズされるので， endpwent 関数を呼び出す必要はない。 

passwd 構造体の構造など，詳細は getpwent 関数を参照のこと 0 

戻り値 —— 該当するデータを見つけることができた場合はパスワードデータへのポインタ 
を返し，見つからなかったか，パスワードファイルをオープンできないなど何ら 
かの原因で失敗した場合は NULL を返して，変数 errno にその原因を示すエラー 
コードを設定する。 

• EMFILE これ以上ファイルをオープンできない 

• EN 0 ENT パスワードファイルが見つからない 

• EN 0 MEM メモリが足りなくなった 

注 意-結果は関数内部の静的領域に格納されるため， getpwent 関数， getpwnam 関数， 

getpwuid 関数のいずれかの関数を呼び出すたびに，内容が上書きされることに 
注意すること。 

規 格 —— Project LIBC Group ， POSIX . l , XPG 3, AES / OS , 4.3 BSD，SYSV 

関連項目 - endpwent , getpwent , getpwuid，setpwent 
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getpwuid 


用 途ーパスワードファイルから ユーザ ID でデータを検索する。 


僅 式- #include < pwd . h > 

struct passwd *getpwuid ^ uid_t uid ); 

解 説一 getpwuid 関数はパスワードファイルから w / ゴで指定した ユーザ ID のデータを検 

索し，そのパスワードデータへのポインタを返す。パスワードファイルは検索終 
了後に自動的にクローズされるので， endpwent 関数を呼び出す必要はない 0 

passwd 構造体の構造など，詳細は getpwent 関数を参照のこと 0 

戻り値——該当するデータを見つけることができた場合はパスワードデータへのポインタ 
を返し，見つからなかったか，パスワードファイルをオープンできないなど何ら 
かの原因で失敗した場合は NULL を返して，変数 errno にその原因を示すエラー 
コードを設定する。 

• EMFILE これ以上ファイルをオープンできない 

• EN 0 ENT パスワードファイルが見つからない 

• EN 0 MEM メモリが足りなくなった 



注 意 —— 結果は関数内部の静的領域に格納されるため， getpwent 関数， getpwnam 関数， 

getpwuid 関数のいずれかの関数を呼び出すたびに，内容が上書きされることに 
注意すること。 

規 格 —— Project LIBC Group ， POSIX . l , XPG 3 y AES / OS ， 4.3 BSD，SYSV 

関埋項目—- endpwent , getpwent , getpwnam , setpwent 
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getrlimit 


用 途—システム制限値を取得する。 


•rf jA - frinc 丄 ude く sys/resources . li > 

mt getrlimit ^mt resource , struct rlimit * rlp ); 

解 説- getrlimit 関数は現在の環境におけるで指定したシステム制限値を耳又得 

し，結果を r //7 が指す領域に格納する。奶⑽似には次の値を指定することがで 
き，その結果はそれぞれ以下のようにして求められる。 


• RLIMIT—CPU 

• RLIMIT_FSIZE 

• RLIMITJDATA 

• RLIMIT.STACK 
參 RLIMIT_CORE 

• RLIMIT_RSS 


CPU 消費時間は無制限 （ RLIM — INFINITY ) 

最大ファイルサイズは Human 68 k が認識する最大のハー 
ドディスクに作成できる最大のファイルのサイズ（概算） 
ヒープ領域の最大サイズは残りメモリいっぱいまで 
スタック領域の最大サイズは最初に確保したサイズまで 
コアファイルの最大サイズは環境変数 limit _ core に指定 
されたバイト数まで 

メモリ空間の最大サイズは残りメモリいっぱいまで 


• RLIMIT.NOFILE 最大オープンフアイル数は 0 PEN _ MAX まで 


また， rlimit 構造体は次のとおり。 
struct rlimit { 

int rlim . cur ; /* 現在の制限値*/ 

int rlim _ max ; /* 設定できる最大の制限値*/ 

}； 


戻り値——正常に取得できた場合は0を返し，失敗した場合には一1を返して，変数 errno 
にその原因を示す エラーコー ドを設定する。 

• EINVAL 不正な resource を指定した 


規 格 —— Project LIBC Group 、 4.3 BSD 
関連項目- setrlimit 
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gets 


用 途—標準入カファイルストリームから文字列を取り出す。 


書式- #include <stdio . h > 

char *gets (char * s ); 


解 説—— gets 関数は標準入力に割り当てられたファイルストリームから文字列を取り出 

し，結果を5が^ : 旨す領域に格納する。文字列の取り出しはファイルの終端に到達 
するか，改行文字に到達するまで続けられる。結果の文字列には改行文字は含ま 
れず，最後に null 文字が置かれることに注意すること。 



戻り値 一 正しく文字列を取り出すことができた場合にはを返す。もしストリーム操作中 
に何らかのエラーが発生した場合はストリームのエラー指示子を設定して NULL 
を返し，ファイルの終端に到達した場合はストリームの終端指示子を設定して 
NULL を返す。失敗した場合は，変数 errno にその原因を示すエラーコードを設 
定する。 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 


注 意—— gets 関数は fgets 関数とは異なり，結果の文字列に改行文字を含まないことに 

注意すること。または結果を格納するのに十分な領域を指していなければなら 
ない。 

規 格一 ANSI C, POSIX.l，XPG3, AES/OS, 4.3BSD, SYSV 

関連項目- ferror , fread 
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getuid 


用 途-実 ユーザ ID を取得する。 

書 式- # include < unistd . h > 

uid_t getuid 、 void ); 

解 説一 getuid 関数はカレントプロセスの実ユーザ ID を返す 0 

戻り値——実 ユーザ ID を返す。 

互換性一 Human 68 k にはユーザ ID の概念がない。そのため getuid 関数では，環境変 
数 UID の値を実ユーザ ID とする。しかし，失敗した場合は0 ( root ) を実ユーザ 
ID とする。 

規 格一 Project LIBC Group，P0SIX.1，XPG3, AES/OS, 4.3BSD, SYSV 

関連項目- geteuid , setgid 
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用 途ーファイルストリームからワードデータを取り出す。 


書 式- #include <stdio.h> 

int getw (FILE 木 stream); 

解 説一 getw 関数は，打で指定したファイルストリームからワードデータを取り出 

す。ワードデータは int 型であり，このサイズは一般に マシンに 依存するが，こ 
こでは 4 バイトロングワードとする。なお getw 関数は，ファイルストリームに 
対してはアラインメント計算を行わない。 



戻り値——正しくワードデータを取り出すことができた場合にはその値を返す。もしスト 
リーム操作中に何らかのエラーが発生した場合はストリームのエラー指示子を設 
定して EOF を返し，ファイルの終端に到達した場合はストリームの終端指示子を 
設定して EOF を返す。失敗した場合は，変数 errno にその原因を示すエラーコー 
ドを設定する。 


• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

互換性—— ZC では getw 関数が取り出すのは 2 バイトショートワードだが， LffiC •では本来 
の定義どおり， int 型を表現する 4 バイトロンダワードを取り出すこととする。 
したがって， getw 関数を用いて作成されたプログラムとは互換性を失う。 

規 格一 ANSI C， POSIX.l， XPG3, AES/OS ， 4.3BSD， SYSV 
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用 途——暦時間を協定世界時間 （ UTC ) に変換する。 


書式- #mcluae く time . h > 

struct tm *gmtime (const time_t * timep ノ； 


解 説一 gmtime 関数は，"爪印が指す領域に格納された暦時間 （エポックタイム） を協定 

世界時間 ( UTC ) に変換し，その結果を tm 構造体に格納してそのアドレスを返す。 
tm 構造体は次のとおり。 


struct tm { 

.• tm. 
int 


int 

int 

int 

int 

int 


tm_min; 
tm_hour; 
tm_mday; 
tm_mon; 
tm_year; 
tm_wday; 
tm_yday; 
tm_isdst; 
tm_gmtoff; 


char *tm_zone : 


>； 


/* 秒 (0-61) ♦/ 

/* 分 (0-59) */ 

/* 時 (0-23) */ 

/* 日 （1-32) */ 

/* 月 (0-11 )*/ 

/* 年（年-190 0) */ 

/* 曜日 (0-7 日曜は 0) */ 

/* 年内の通算日 (0-365) */ 

/* サマータイム （0-1 実施中なら 1)*/ 
/* グリニッジから西回り*/ 

/* タイムゾーン名*/ 


戻り値——正常に変換できた場合は tm 構造体へのポインタを返し，失敗した場合には NULL 
を返す。 


注 意一結果は関数内部の静的領域に格納されるため， localtime 閨数， gmtime 関数， 

asctime 関数， ctime 関数のいずれかの関数を呼び出すたびに，内容が上書きさ 
れることに注意すること。 

規 格 —— ANSI C , POSIX .1 ， XPG 3, AES / OS ， 4.3 BSD，SYSV 
関埋項目- asctime , ctime ， localtime , tzset 
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IJUMP 


用 途- rts 命令を用いた大域ジャンプを実行する。 


僅 式 - #include〈interrupt .h> 

void IJUMP (void *addr); 


解 説—— IJUMP は rts 命令をうまく用いて， a ゴみで指定したアドレスに大域ジャンプを 

行う。これは，割り込みなどで元のベクタにジャンプするために使用する。なお 
IJUMP が行われる前には，通常の後知;理と同じように，関数内部で破壊したレジ 
スタはすべて復帰される。 

戻り値——なし。 IJUMP は決して戻ってこない。 

注 意——元の割り込みべクタへのジャンプなど，限られた用途にだけ使用すること。もし 

一般的な大域ジャンプを行いたい場合には， setjmp 関数および 10 ngjmp 関数を 
使用しなければならない。 



互換性-この機能は X 68000 Programming Series #1 X 68000 Develop . に付属する吉野 

氏が移植された GCC でしか使用することができない。移植性を考慮するならば 
使用しないこと。 


規 格- Project LIBC Group 

関連項目一 IJUMPJITE, IRTE，IRTS 
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■JUMP RTE 


用 途——割り込みルーチンの宣言と rte 命令へのジャンプを実行する。 

書 式-# include <interrupt .h> 

void IJUMP.RTE (void); 

解 説—— I JUMP _RTE は割り込み処理関数での rte 命令へのジャンプを行う。 

IJUMP_RTE が使用されると，その関数は純粋な割り込み処理関数としてコンパイ 
ルされる。つまり，その関数から外部の関数を呼び出さなければその関数で破壊 
されるレジスタだけが，呼び出す場合はすべてのレジスタが退避/復帰されるよ 
う にコ ンノヽ 。イノレされる 0 

戻り値——なし。 IJUMP_RTE は決して戻ってこない。 

互換性-この機能は X68000 Programming Series #1 X68000 Develop . に付属する吉野 

氏が移植された GCC でしか使用することができない。移植性を考慮するならば 
使用しないこと。 

規 格- Project LIBC Group 

関連項目—— IJUMP, IRTE, IRTS 
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IRTE 


用 途一割り込みルーチンの宣言と rte 命令による復帰を実行する0 


書式 - #include <interrupt.il> 

void IRTE (void) ; 


解 説 - IRTE は rte 命令を用いて，割り込みルーチンから復帰する。割り込みルーチン 

では， return の代わりに IRTE を使用すること。 


IRTE が使用されると，その関数は純粋な割り込み処理関数としてコンパイルさ 
れる。つまり，その関数から外部の関数を呼び出さない場合はその関数で破壊さ 
れる レジスタ だけが，呼び出す場合はすべての レジスタ が退避/復帰されるよう 
にコ ンパイノレされる0 

戻り値——なし。 IRTE は決して戻ってこない。 



注 意—— IRTE と IRTS は同時には使用しないこと。また，割り込み処理関数以外では使用 
しないこと。使用した場合，その動作は不定である。 


互換性-この機能は X68000 Programming Series #1 X68000 Develop . に付属する吉野 

氏が移植された GCC でしか使用することができない。移ネ直性を考慮するならば 
使用しないこと。 


規 格- Project LIBC Group 

関連項目—— IJUMP, IJUMP_RTE, IRTS 
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IRTS 


用 途——全レジスタを保存する関数を宣言する。 

書式-# include〈interrupt . h > 

void IRTS ( void ); 

解 説一 IRTS は rts 命令を関数から復帰する。レジスタ退避型関数では， return の代わ 
りに IRTS を使用すること。 

IRTS が使用されると，その関数はレジスタ退避型関数としてコンパイルされる。 
つまり関数内部で使用される/されないに関わらず，すべてのレジスタが保存さ 
れるようにコンパイルされる。 

戻り値——なし。 IRTS は決して戻ってこない。 

注 意—— IRTS と IRTE は同時には使用しないこと。 

互換性-この機能は X68000 Programming Series #1 X68000 Develop. に付属する吉野 

氏が移植された GCC でしか使用することができない。移植性を考慮するならば 
使用しないこと。 

規 格 —— Project LIBC Group 
関連項目—— IJUMP , IJUMP _ RTE , IRTE 
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is 68881 


用 途——数値演算コプロセッサの種類を調べる。 

書 式 - #include <sys/xmath.h> 

int _is 68881 (void); 


解 説一 _is 68881 閨数は数値演算コプロセッサが実装されているかどうかを調べ，実装さ 

れている場合はその種類を返す。 


戻り値——数値演算コプロセッサが実装されていた場合はその種類を返し，実装されていな 
い場合は一1を返す。 


• MC 68882 0 を返す 

• MC 68881 1 を返す 



注 意——数値演算コプロセッサの種類を区別するため，内部の ROM OFFSET $01 を読み出 

して判定している。この部分は未定義であり，将来変更される可能性がある。 

_is 68881 関数はライブラリの内部関数なので，移植性を考慮するならば使用し 
ないこと。 

規 格- Project LIBC Group 
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isleap 


用 途——閏年補正の必要性について調べる。 

書 式- #include < sys/xtime . h > 

int _isleap (int month , mt year ); 

解 説—— . isleap 関数は，ア^ 7 •で指定した年の month 月 が閏年補正をすべきかどうかにつ 
いて調べる。閏年補正を行わなければならないのは閏年の2月だけであり，閏年 
とは西暦年が 4 で割り切れる年のことである。ただし閏年でも 100 で割り切れ， 
400 で割り切れない年は閏年ではない。 

戻り値——閏年補正をしなくてはならなければ1を，しなくてよいならば〇を返す。 

注 意——単純にパ ar の値を評価したいだけならば，には2を指定するとよい0 

_ isleap 関数はライブラリの内部関数なので，移植性を考慮するならば使用しな 
いこと。 

規 格'- Project LIBC Group 
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index 


用 途—文字列中から指定文字を検索する。 

書式- #include く string 上〉 

char *index (const char * string , int character ); 

解 説—— index 関数は，打/が指す文字列中から c / zfl ； 饥で指定された文字を検索す 

る。 string 末尾の null 文字も検索の対象となりうる 。 character [±， 内部で int 
型から char 型に変換される 0 

戻り値——於/ 7>2 ぎ中で最初に現れた c/za/mto* へのポインタを返し，見つからない場合は NULL 
を返す。 

注 意-1文字は1バイトとなる。 

規 格—— 4.3BSD 

関連項目- memchr , strchr , strcspn , strpbrk , strrchr , strspn , strstr , strtok 
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#define MFP_INT_MASK(mask) \ 

({ \ 

register unsigned short ret; \ 

asm volatile ( \ 

"lea.l $e 8801 3,a0\n\t" \ 

"movep.w 0(a0) , # / 0 0\n" \ 

"move.w # /,cl,dl\n" \ 

"movep.w dl,0(a0)\n" \ 

: "=d" ((unsigned short) (ret)) \ 
: "d" ((unsigned short) (mask)) \ 

: "dl","aO"); \ 

ret; \ 

}) 

void main (void) 

{ 

int lv, ssp; 
unsigned short mfpmask; 

/* 割り込みをマスクする */ 
lv = intlevel ⑺; 

/* スパ ー バイザモードにする */ 
ssp = _dos_super (0) ; 

/* MFP MASK を設定 */ 

mfpmask = MFP_INT_MASK (0); 

printf ("MFP MASK = */.X\n", mfpmask); 


/* MFP MASK を元に戻す */ 
mfpmask = MFP_INT_MASK (mfpmask); 
printf ("MFP MASK = y.X\n", mfpmask); 


intlevel 


用 途—— CPU ステータスレジスタの 割り込みマスクを設定する。 

書式-# include < interrupt . h > 

void intlevel 、丄 evel ); 

解 説 —— intlevel 関数は， CPU ステータスレジスタの割り込みマスクビット である 
( J 2 , ん ん）にか阳/の値を設定する。 ユーザモー ドからの設定が可能である。 

戻り値——変更前の割り込みマスク（んんん）の値を返す。 

規 格- Project LIBC Group 

サンプル —— m b _ maasiMMwfeJCSfc— 

1: #include <stdio.h> 

2 : #include <interrupt.h> 

3 : #include <sys/dos.h> 

4: 


56789 10111213141516171819202122232425262728293031323334353637 
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38: /* スーパーバイザモードを元に戻す */ 

39: if(ssp > 0) 

40: _dos_suDer (ssp) ; 

41: 

42: /* 割り込みレベルを元に戻す */ 

43 : intlevel (lv) ; 

44: > 
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isainum 


用 途一英数字かどうかを調べる。 

式- frmc 丄 ude <ctype . h > 

mt isainum unt c ); 

解 説—— isainum 関数は， c で指定した文字コードを現在のロケールの LC - CTYPE カテゴ 
リに照らし合わせ，英数字であるかどうかを調べる。 

戻り値—— C が英数字であれば0以外の値を返し，異なれば0を返す。 

注 意- c は int 型の引数だが，その値は unsigned char 型で表現できる範囲の値かある 

いは EOF と同値でなければならない。この範囲を越える部分については，その動 
作は未定義である。 

通常， isainum 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義 
されると実体をもつ関数となる。 isainum 関数がマクロとして展開される場合は， 
引数が副作用を伴わないように注意すること。 

LIBC は C ロケールしかサポートしていない。 

規 格 —— Project LIBC Group, ANSI C, POSIX.l , XPG3, AES/OS, 4.3BSD, 
SYSV 

関连項目- is alpha , isascii , iscntrl , isdigit，is graph , isiso , islower , isodigit , 

isprint , ispunct , isspace , isupper , isxdigit 
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isalpha 


用 途ーアルファべットかどうかを調べる。 

書式- #include < ctype . h > 

int isalpha ^int c ); 

解 説一 isalpha 関数は， C で指定した文字コードを現在のロケールの LC — CTYPE カテゴ 
リに照らし合わせ，英字（アルファべット）であるかどうかを調べる。 

戻り値 一 c が 英字 （アルファベット） であれば〇以外の値を返し，異なれば〇を返す。 

注 意- c は int 型の引数だが，その値は皿 signed char 型で表現できる範囲の値かある 

いは EOF と同値でなければならない。この範囲を越える部分については，その動 
作は未定義である。 

通常， isalpha 関数はマクロとして定義されるが， — NO - CTYPE - INLINE — が定義 
されると実体をもつ関数となる。 isalpha 関数がマクロとして展開される場合は, 
引数が副作用を伴わないように注意すること。 

L 7 BC は C ロケールしかサポートしていない。 

規 格 —— Project LIBC Group, ANSI C、POSIX.l, XPG3, AES/OS, 4.3BSD y 
SYSV 

関連項目—— isalnum ， isascii , iscntrl , isdigit , isgraph , isiso ， islower , isodigit , 
isprint , ispunct , isspace , isupper , isxdigit 
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isascn 


用 途一7ビット ASCII 文字かどうかを調べる。 

# 式 - #mclude < ctvpe . h > 

int isascii (int c ); 

解 説一 isascii 関数は， £ •で指定した文字コードが7ビット ASCII 文字 （0 x 00 〜 0 x 7 F ) 
であるかどうかを調べる。 

戻り値一 c が7ビット ASCII 文字であれば0以外の値を返し，異なれば0を返す。 

注 意一 cit int 型の引数だが，その値は unsigned char 型で表現できる範囲の値か，あ 
るいは EOF と同値でなければならない。この範囲を越える部分については，その 
動作は未定義である。 

通常， isascii 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義 
されると実体をもつ関数となる 0 isascii 関数がマクロとして展開される場合は, 
引数が副作用を伴わないように注意すること。 

isascii 関数はロケールとは関係はない。 

規 格 —— Project LIBC Group , XPG 3, AES / OS ， 4.3 BSD , SYSV 

関埋項目- isalnum , isa 丄 pha ， iscntrl , isdigit , isgraph , isiso , islower , isodigit , 

isprint , ispunct , isspace , isupper 
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■satty 


用 途-端末デノくイスであるかどうかを調べる0 


書 式" - #include < unistd . h > 

int isatty (int fildes ); 

解 説 一 isatty 関数は，力/ゴ打で指定したファイルハンドルが指すファイルが端末デバイ 
ス（キャラクタデバイス）であるかどうかを調べる。 

戻り値 一 端末デバイスならば1を返し，端末デバイスでなければ〇を返して，変数 errno 
にその原因を示すエラーコードを設定する。 

• EBADF 不正な fildes を 指定した 

• EN 0 TTY 端末デバイスではない 



規格—— POSIX.1 , XPG3, AES / OS ，4.3 BSD , SYSV 
関連項目- ttyname 
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isblank 


用 途ーブランク文字かどうかを調べる。 

書式- #include <ctype . h > 

mt isblank、int c ); 

解 説—— isblank 関数は， c で指定した文字コードを現在のロケールの LC - CTYPE カテゴ 

リに照らし合わせ，ブランク文字（スペース）であるかどうかを調べる。 

戻り値—— c が記号であれば0以外の値を返し，異なれば0を返す。 

注 意- isspace 関数との違いに気をつけること。 

c は int 型の引数だが，その値は unsigned char 型で表現できる範囲の値かある 
いは EOF と同値でなければならない。この範囲を越える部分については，その動 
作は未定義である。 

通常， isblank 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義 
されると実体をもつ関数となる。 isblank 関数がマクロとして展開される場合は, 
引数が副作用を伴わないように注意すること。 

LiBC は C ロケールしかサポートしていない。 

規 格- Project LIBC Group 

関埋項目- lsalnum，is alpha , isascii , iscntrl , lsdigit , is graph , isiso , lsiower ， 

isodigit , isprint , ispunct , isspace ， isupper , isxdigit 
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iscntrl 


用 途一制御文字かどうかを調べる。 

書式- #include く ctype . h 〉 

int iscntrl(mt cj ; 

解 説—— iscntrl 関数は， c で指定した文字コードを現在のロケールの LC — CTYPE カテゴ 
リに照らし合わせ，制御文字 （コン トロール文字）であるかどうかを調べる。 

戻り値—— c が制御文字であれば0以外の値を返し，異なれば0を返す。 

注 意- c は int 型の引数だが，その値は unsigned char 型で表現できる範囲の値か，あ 

るいは EOF と同値でなければならない。この範囲を越える部分については，その 
動作は未定義である。 

通常， iscntrl 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義 
されると実体をもつ関数となる。 iscntrl 関数がマクロとして展開される場合は, 
引数が副作用を伴わないように注意すること。 

LIBC は C ロケールしかサボートしていない。 

規 格 —— Project LIBC Group，ANSI C, POSIX.l, XPG3, AES/OS, 4.3BSD， 
SYSV 

関埋項目- isalnum , isalpha , isascii ， isdigit , isgraph ， isiso ， islower , isodigit ， 

isprint , ispunct ， isspace ， isupper , isxdigit 






ライブラリー第 2 部 


isdigit 


用 途——数字かどうかを調べる。 

書 式- # include く ctype . h 〉 

int isdigit (int c ); 

解 説—— isdigit 関数は， c で指定した文字コードを現在のロケールの LC — CTYPE カテゴ 
リに照らし合わせ，数字であるかどうかを調べる。 

戻り値—— c が数字であれば0以外の値を返し，異なれば0を返す。 

注 意- c は int 型の引数だが，その値は皿 signed char 型で表現できる範囲の値か，あ 

るいは EOF と同値でなければならない。この範囲を越える部分については，その 
動作は未定義である。 

通常， isdigit 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義 
されると実体をもつ関数となる。 isdigit 関数がマクロとして展開される場合は, 
引数が副作用を伴わないように注意すること。 

は C ロケールしかサポートしていない。 

規格一 Project LIBC Group, ANSI C, POSIX.l, XPG3, AES/OS, 4.3BSD， 
SYSV 

関連項目- isalnum , isascii , iscntrl ， isgraph , isiso ， islower ， isodigit , 

isprint , ispunct , isspace ， isupper , isxdigit 


178 






Chapter 1— C 標準関数ライブラリ 


isqraph 


用 途——表示可能文字かどうかを調べる。 

書 式- #include < ctype . h > 

int lsgraph (mt c ); 

解 説一 isgraph 関数は， e で指定した文字コードを現在のロケールの LC — CTYPE カテゴ 
リに照らし合わせ，表示可能文字（スペースを除く印字可能文字）であるかどうか 
を調べる。 

戻り値—— c が表示可能文字であれば0以外の値を返し，異なれば〇を返す。 

注 意- c は int 型の引数だが，その値は unsigned char 型で表現できる範囲の値か，あ 

るいは EOF と同値でなければならない。この範囲を越える部分については，その 
動作は未定義である。 

通常， isgraph 関数はマクロとして定義されるが， -_ NO _ CTYPE _ INLINE „ が定義 
されると実体をもつ関数となる。 isgraph 関数がマクロとして展開される場合は, 
引数が副作用を伴わないように注意すること。 

L 仿 C は C ロケールしかサポートしていない。 

規 格 一 Project LIBC Group，ANSI C ， POSIX . l ， XPG 3, AES / OS ，4.3 BSD , 
SYSV 

関連項目—— isalnum , is alpha , isascii , iscntrl , isdigit , isiso ， islower ， isodigit ， 
isprint ， ispunct , isspace ， isupper , isxdigit ， 
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ライブラリー第 2 部 


isinf 


用 途——無限大かどうかを調べる。 

書 式- # include < math . h > 

int isinf (double value ); 

解 説一 isinf 関数は， va / we の数値が無限大（符号は問わない）かどうかを調べる。 
戻り値——数値が無限大ならば〇以外の値を返し，無限大でなければ〇を返す。 

規 格 —— Project LIBC Group 


関連項目- isnan 







Chapter 1— C 標準関数ライブラリ 


isiso 


用 途——8ビット ISO 文字かどうかを調べる。 

書式- #include <ctype . h > 

int isiso (int c ); 

解 説一 isiso 関数は， c で指定した文字コードが 8 ビット ISO 文字 （0 x 00 〜 OxFF ) であ 
るかどうかを調べる。 

戻り値—— c が8ビット ISO 文字であれば0以外の値を返し，異なれば0を返す。 

注 意—— c は int 型の引数だが，その値は unsigned char 型で表現できる範囲の値か，あ 

るいは EOF と同値でなければならない。この範囲を越える部分については，その 
動作は未定義である。 

通常， isiso 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義され 
ると実体をもつ関数となる。 isiso 関数がマクロとして展開される場合は，引数 
が副作用を伴わないように注意すること。 

isiso 関数はロケールとは関係がない。 

規 格- Project LIBC Group 

関連項目- isalDha , isascii ， iscntrl ， isdigit , is graph , is 丄 ower ， isodigit ， 

isprint , ispunct , isspace ， isupper , isxdigit 
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ライブラリー第 2 部 


■slower 


用 途——英小文字かどうかを調べる。 

書 式- # include <ctype . h > 

int lslower unt c ); 

解 説—— islower 関数は， C で指定した文字コードを現在のロケールの LC - CTYPE カテゴ 
リに照らし合わせ，英小文字であるかどうかを調べる。 

戻り値 —— C が英小文字であれば0以外の値を返し，異なれば0を返す。 

注 意- c は int 型の引数だが，その値は unsigned char 型で表現できる範囲の値か，あ 

るいは EOF と同値でなければならない。この範囲を越える部分については，その 
動作は未定義である。 

通常， islower 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義 
されると実体をもつ関数となる。 islower 関数がマクロとして展開される場合は， 
引数が副作用を伴わないように注意すること。 

L / BC は C ロケールしかサポートしていない。 

規 格 —— Project LIBC Group, ANSI C，POSIX.l, XPG3, AES/OS, 4.3BSD, 
SYSV 

関連項目- isalnum , is alpha , isascii , iscntrl ， isdigit , is graph , isiso , isodigit , 

isprint , ispunct , isspace , isupper , isxdigit 
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Chapter 1— C 標準関数ライブラリ 


isnan 


用 途——非数かどうかを調べる。 

書式- #include < math . h > 

int isnan (double value ); 

解 説—— isnan 関数は wz / 敗の数値が非数かどうかを調べる。 L/BC では Quiet NaN と 
Signaling NaN の区別はしない。 

戻り値——数値が非数ならば0以外の値を返し，非数でなければ〇を返す。 

規 格 —— Project LIBC Group, XPG3, AES/OS 
関連項目- is inf 
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isoaiqit 


用 途-8進数字かどうかを調べる。 

rf 式-# include <ctype . h > 

int isodigit (int c ); 

解 説—— isodigit 関数は， c で指定した文字コードが 8 進数字であるかどうかを調べる。 
8進数字とは0〜7のことを指す。 

戻り値—— C が8進数字であれば0以外の値を返し，異なれば0を返す。 

注 意—— C は int 型の引数だが，その値は unsigned char 型で表現できる範囲の値か，あ 

るいは EOF と同値でなければならない。この範囲を越える部分については，その 
動作は未定義である。 

通常， isodigit 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義 
されると実体をもつ関数となる。 isodigit 関数がマクロとして展開される場合 
は，引数が副作用を伴わないように注意すること。 

isodigit 関数はロケールとは関係がない。 

規 格 —— Project LIBC Group，MS-C7.0 

関連項目- lsalnum,isa 丄 pha ， isascii , iscntrl , lsdierit , is graph , isiso, lslower , 

isodigit , i sprint, ispunct, isspace, isuDper 
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isorint 


用 途——印字可能文字かどうかを調べる。 

書式- #include く ctype . li > 

int isprint (mt c ノ； 

解 説一 isprint 関数は， C で指定した文字コードを現在のロケールの LC — CTYPE カテゴ 
リに照らし合わせ，印字可能文字であるかどうかを調べる。 

戻り値—— c が印字可能文字であれば0以外の値を返し，異なれば〇を返す。 

注 意-(:は int 型の引数だが，その値は皿 s igned char 型で表現できる範囲の値か，あ 

るいは EOF と同値でなければならない。この範囲を越える部分については，その 
動作は未定義である。 

通常， isprint 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義 
されると実体をもつ関数となる。 isprint 関数がマクロとして展開される場合は, 
引数が副作用を伴わないように注意すること。 

L 7 SC •は C ロケールしかサポートしていない。 

規 格一 Project LIBC Group，ANSI C , POSIX . l , XPG 3, AES / OS ，4.3 BSD ， 
SYSV 

関連項目- isalnum , isalpha , isascii , iscntrl , isdigit ， isgraph ， isiso ， islower ， 

isodigit , ispunct , isspace , isupper , isxdigit 
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ライブラリー第 2 部 


■spunct 


用 途一記号文字かどうかを調べる。 

谱式- #include く ctype . h 〉 

mt lSDunct ^mt c ); 

解 説—— i spunct 関数は， c で指定した文字コードを現在のロケールの LC_CTYPE カテゴ 
リに照らし合わせ，記号文字であるかどうかを調べる。 

戻り値—— C が記号文字であれば0以外の値を返し，異なれば0を返す。 

注 意—— C は int 型の引数だが，その値は unsigned char 型で表現できる範囲の値か，あ 

るいは EOF と同値でなければならない。この範囲を越える部分については，その 
動作は未定義である。 

通常， ispunct 関数はマクロとして定義されるが， __ NCLCTYPE _ INLINE __ が定義 
されると実体をもつ関数となる。 ispunct 関数がマクロとして展開される場合は， 
引数が副作用を伴わないように注意すること。 

L 75 C は C ロケールしかサポートしていない。 

規 格—— Project LIBC Group, ANSI C , POSIX.l , XPG3 ， AES/OS, SYSV，4.3BSD 

関埋項目- isalnum , is alpha , isascii , iscntrl , isdigit , is graph , isiso , islower , 

isodigit , isspace , isupper , isxdigit 
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isspace 


用 途——空白文字かどうかを調べる。 

僅 式- #mclude <ctype . h > 

int isspace unt c ); 

解 説—— isspace 関数は，（:で指定した文字コードを現在のロケールの LC - CTYPE カテゴ 

リに照らし合わせ，空白文字（スペース/タブ/改行/復帰/垂直タブ/改頁など）で 
あるかどうかを調べる。 

戻り値—— c が記号であれば0以外の値を返し，異なれば0を返す。 

注 意- c は int 型の引数だが，その値は unsigned char 型で表現できる範囲の値か，あ 

るいは EOF と同値でなければならない。この範囲を越える部分については，その 
動作は未定義である。 

通常， isspace 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義 
されると実体をもつ関数となる。 isspace 関数がマクロとして展開される場合は， 
引数が副作用を伴わないように注意すること。 

は C ロケールしかサポートしていない。 

規 格 —— Project LIBC Group , ANSI C , POSIX . l ， XPG 3, AES / OS ，4.3 BSD ， 

SYSV 

関埋項目- isalnum ， isalpha ， isascii , iscntrl , isdigit , isgraph , isiso , is 丄 ower ， 

isodigit , isprint ， ispunct ， isupper , isxdigit 
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ライブラリー第 2 部 


■simper 


用 途——英大文字かどうかを調べる。 

書 式^- -#include < ctype . h > 

int lsupper unt c ); 

解 説—— isupper 閨数は， C で指定した文字コードを現在のロケールの LC - CTYPE カテゴ 
リに照らし合わせ，英大文字であるかどうかを調べる。 

戻り値—— c が英大文字であれば0以外の値を返し，異なれば0を返す。 

注 意—— C は int 型の引数だが，その値は unsigned char 型で表現できる範囲の値か，あ 

るいは EOF と同値でなければならない。この範囲を越える部分については，その 
動作は未定義である。 

通常， isupper 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義 
されると実体をもつ関数となる。 isupper 関数がマクロとして展開される場合は， 
引数が副作用を伴わないように注意すること。 

LiBC は C ロケールしかサポートしていない。 

規 格 —— Project LIBC Group，ANSI C , POS 1 X .1、 XPG 3, AES / OS ，4.3 BSD , 
SYSV 

関連項目 一一 isalnum，is alpha , isascii ， iscntrl , isdigit , is graph , isiso，is 丄 ower ， 
isodigit , isprint , ispunct ， isspace ， isxdigit 
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isxdiqit 


用 途——16進数字かどうかを調べる。 

書式- #include < ctype . h > 

int isxdigit (int c ); 

解 説一 isxdigit 関数は， c で指定した文字コードが 16 進数字であるかどうかを調べる。 
16進数字とは〇〜9， A 〜 F および a 〜 f のことを指す。 

戻り値一 c が16進数字であれば0以外の値を返し，異なれば0を返す。 

注 意- C は int 型の引数だが，その値は unsigned char 型で表現できる範囲の値か，あ 

るいは EOF と同値でなければならない。この範囲を越える部分については，その 
動作は未定義である。 

通常， isxdigit 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE — が定義 
されると実体をもつ関数となる。 isxdigit 関数がマクロとして展開される場合 
は，引数が副作用を伴わないように注意すること。 

isxdigit 関数はロケールとは関係がない。 

規 格 —— Project LIBC Group，ANSI C, POSIX.l, XPG3 y AES/OS, 4.3BSD, 

SYSV 

関連項目- isalnum , isalpha ， isascn , iscntrl ， isdigit , isgraph , isiso , islower , 

isodigit , isprint , ispunct , isspace , isupper 
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ライブラリー第 2 部 


kbhit 


用 途 一ー コンソールへの入力の有無を調べる。 

書式 - #inc 丄 ude <conio .h> 

int kbhit (void); 

解 説—— kbhit 関数は コンソールの 状態を調べ，キーボードが押されているか（あるいは入 

カデータがあるか）どうかを調べる。 kbhit: 関数はつねにコンソールの状態を調 
べるので，標準入力の状態に左右されることも stdio ライプラリによるバッファ 
リングの作用も受けない。 

kbhit 関数は入力を待たないが，すでにキーポード バッファに データがある場合 
や ungetch 関数によって押し戻されたデータがある場合は，それらを入カデータ 
として認識する。 

戻り値——キーボードが押されていれば（入カデータがあれば）そのデータを返し，なければ 
0を返す。 エラーは ない。 

注 意一 kbhit 関数は入カデータがあるかどうかを調べるためのものであり，必ずしも 

キーボードが押されているかどうかを調べることにはならない。 

規 格 —— Project LIBC Group、MS-C7.0 

関連項目- getch, getche 
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kill 


用 途—プロセスに対してシグナルを送信する。 


書式 - #include く signal.h> 

int kill (Did_t pid, int sig); 


解 説—— kill 関数は， 〆 ゴで指定したプロセスに対してで指定したシグナルを送信す 

る。ただし，では自プロセスに対するシグナル送信しかサポートしてい 
ない0 


戻り値——正常にシグナルを発生できた場合は〇を返し，失敗した場合には一1を返して，変 
数 errno に その 原因を示す エラー コードを設定する。 


• EINVAL 不正なシグナル番号地を指定した 

• ESRCH pid で指定したプロセスが存在しない 

注 意——自プロセスに対してシグナルを送信する場合には， 〆 ゴに getpid 関数で求めたプ 
ロセス ID を指定するか，： raise 関数を使用すること。 



互換性一 Human 68 k はシグナル機構をサポートしていないので，では内部でソフ 
卜的に例外を発生させることでシグナル処理を行っている。したがって LIBC で 
は，自プロセス以外にシグナルを送信することはできない。 


規 格一 POSIX.l、XPG3, AES/OS, 4.3BSD，SYSV 

関埋項目- getpid, raise, sigaction, signal 
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ライブラリー第 2 部 


labs 


用 途-10 ng 型の値の絶対値を取得する。 

書 式- #include <stdlib.h> 

long labs (long n); 

解 説—— labs 関数は 《 の絶対値を返す。 

戻り値——《の long 型絶対値を返す 0 

注 意——通常， labs 関数はマクロとして定義されるが， -_NCLSTDLIB_INLINE__ が定義さ 

れた場合には実体をもつ関数となる。 

規 格 —— ANSI C, SYSV 

関連項目- abs, div, ldiv, wabs 
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Idexp 


用 途—— a : に 2 exp を乗じた値を返す。 


書 式- #include < math . h > 

double Idexp (doub 丄 e x,int * exp ); 

#inelude < sys / xmath . h > 
double _ f_Idexp (double x , int * exp ); 
double _ fe_ldexp (double x , int * exp ); 
double _ fpu_ldexp (double x , int * exp ); 


解 説—— Idexp 関数は; c に 2 ea : p を乗じた値を返す。各関数はそれぞれ次のように動作する 0 


•Idexp 


• _f _ldexp 

• _ fe_ldexp 

• _ fpu_ldexp 


数値演算コプロセツサが使用できる場合は数値演算コプロ 
セッサを直接ドライブし，使用できない場合はソフトウヱ 
アエミュレートする 

数値演算コプロセッサ命令を直接ドライブする 

ソフトウェアエミュレートする 

I / O 数値演算コプロセッサを直接ドライブする 



戻り値——正しく値が求められた場合はその値を返す 0 もし JC が非数 （ NaN ) ならば変数 errn0 
にその原因を示すエラーコードを設定して同じく非数を返し，ズが0ならば変数 
errno にその原因を示すエラーコードを設定して同じく 0を返し，オーバーフ 
ローした場合は変数 errno にその原因を示すエラーコードを設定して HUGE-VAL 
を返す。 

• EDOM ズの値が非数 

• ERANGE X が0 

• ERANGE 計算結果が才ーバーフローした 


注 意—— < math . li > を読み込む前に， _ JDIRECT _ FLOAT __ が定義されているときは Idexp は 

_ fe _ ldexp の別名となり， — DIRECT - IOFPU — が定義されているときは Idexp は 
_ fpu _ ldexp の別名となる。また， __ DIRECT _ FPU „ が定義されているときは Idexp 
は- f — Idexp の別名となる。 

数値演算コプロセッサの場合のみ， ERANGE が設定される。 
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規 格 —— Project LIBC Group，ANSI C，POSIX.l, XPG3, AES/OS, 
SYSV 

関連項目- frexp , modf 


4.3BSD， 
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Chapter 1 一 C 標準関数ライブラリ 


Idiv 


用 途- long 型整数の除算を実行する。 

書 式- #include く stdlib . h 〉 

laiv_t 丄 div (long number,long denom ); 

解 説- ldiv 関数は， long 型の整数であるをみ似 m で割った商と剰余を求める。 

符合は引数の符合が同じであれば正，異なれば負となる。またみ/で割り切れ 
ない場合，計算結果は代数学上の商よりも小さい最大の整数となる。 

戻り値——除算の結果を ldiv _ t 構造体に代入し，その構造体を返す。構造体の定義は次の 
とおりであり， quot に商を， rem に剰余を格納する。 


■ 


規格 —— ANSI C，SYSV 
関連項目- div , floor 


struct •[ 

long quot; /* 商 */ 

long rem; /* 剰余 */ 

>； 

注 意——変換した結果が long 型で表現できない場合，その結果は不定である。 
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localtime 


用 途——暦時間を地域時間に変換する。 

書 式- # include <time . h > 

struct tm *localtime ^const time_t * timep ); 

解 説—— localtime 関数は，伽!印が指す領域に格納されている暦時間（エポックタイム） 

をタイムゾーンの設定にしたがって地域時間に変換し，その結果を tm 構造体に 
格納してそのアドレスを返す。 

localtime 関数は，変換にさきだって tzset 関数を呼び出して地域時間情報を再 
計算する。 tm 構造体は次のとおり0 


struct tm 

i 




int 

tm_sec; 

/* 

秒 (0-61) */ 


int 

tm_min; 

/* 

分 (0-59) */ 


int 

tm_hour; 

/* 

時 (0-23) */ 


int 

tm_mday; 

/* 

日 （ 1-32) */ 


int 

tm_mon; 

/* 

月 (0-11) */ 


int 

tm_year; 

/* 

年（年- 190 0) */ 


int 

tm_wday ; 

/* 

曜日 (0-7 日曜は 0) 

本/ 

int 

tm.yday ; 

/* 

年内の通算日 (0-365) 

*/ 

int 

tm_isdst ; 

/* 

サマータイム （ 0-1 実施中なら 1) */ 

int 

tm.gmtoff; 

/* 

グリニッジから西回り 

*/ 

char 

*tm_zone ; 

/* 

タイムゾーン名 */ 



>； 


戻り値——正常に変換できた場合は tm 構造体へのポインタを返し，失敗した場合には NULL 
を返す。 

注 意——結果は関数内部の静的領域に格納されるため， localtime 関数， gmtime 関数, 

asctime 関数， ctime 関数のいずれかの関数を呼び出すたびに，内容が上書きさ 
れることに注意すること。 

規 格 —— ANSI C , POSIX . l , XPG 3, AES / OS , 4.3 BSD , SYSV 

関埋項目- asctime , ctime ， gmtime , tzset 
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locking 


用 途ーファイル中の領域ロックの設定/解除を実行する。 

書式- #mclude < sys / lockmg . h > 

mt locking (mt エ lides，mt mode , long n ); 

解 説一 locking 関数は，打で指定したファイルハンドルが t 旨すファイルの現在位置 

から《の領域に対して，ロックを設定あるいは解除する。一度ロックが設定され 
ると，ロックを行ったプロセス以外からは一切読み書きできなくなる。ロック方 
法は wo みで指定することができ，以下の値を取る。 

• LK 丄 0 CK 指定された領域をロックする。ロックできない場合は1秒ご 

とに1回，合計10回までリトライする 

• LKJILCK 指定された領域をロックする。ロックできない場合は1秒ご 

とに1回，合計10回までリトライする 

• LK_NBLCK 指定された領域をロックする 

• LK_NBRLCK 指定された領域をロックする 

• LKJJNLCK 指定された領域に設定されているロックを解除し，他のプロ 

セスからもアクセスできるようにする 

戻り値——正常にロック設定/解除できた場合は〇を返し，失敗した場合には 一1 を返して， 
変数 errno にその原因を示す エラーコード を設定する。 

• EBADF 不正な fildes を 指定した 

• EINVAL 不正な mode を指定した 

• EDEADL 0 CK 10回リトライしてもロックを設定できない 



注 意——1つのファイル中に複数のロック領域を設定することができるが，それぞれを重 
複させることはできない。また，領域が隣り合っていても，それぞれ1つの領域 
として扱われることに注意すること。 

locking 関数を使用するには， “ CONFIG . SYS ” に SHARE = を記述してファイルシエ 
アリングができるようにしておく必要がある。 

規 格 —— Project LIBC Group, MS-C7.0 

関連項目- ere at , open 
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用 途——自然対数 Zc ^( x ) を求める。 

書 式- # include < math . h > 

double log ^double x ); 

#include < sys / xmath . h > 
double _ f _ 1 og (double x ); 
double _ fe_log (double x ); 
double _ fpu_log (double x ); 

解 説—— log 関数は; c の自然対数（ログ）を求める。各関数はそれぞれ次のように動作する。 

•log 数値演算コプロセッサが使用できる場合は数値演算コプロセッサ 

を直接ドライブし，使用できない場合は FLOAT パッケージを呼 
び出す 

• _ f_log 数値演算コプロセッサ命令を直接ドライブする 

• _feJLog FLOAT パッケージを呼び出す 

• _ fpu_log I / O 数値演算コプロセッサを直接ドライブする 

戻り値——正しく値が求められた場合， log 関数は re > 0の範囲でズの自然対数を返す。ま 
た， ズの値が x = 0だと オーバーフローを 起こす。もし x が非数 （ NaN ) ならば変数 
errno に その 原因を示す エラーコー ドを設定して同じく非数を返し，それ以外の 
エラーでは 変数 errno にその原因を示す エラーコー ドを設定して無限大を返す 0 

• EDOM JC の値が非数，またはズの値が計算範囲外 

• ERANGE 計算結果が才ーバーフローした 

注 意一く math . h > を読み込む前に， __ DIRECT _ FLOAT __ が定義されているときは log は 

_f e _ log の別名となり， __ DIRECT _ IOFPU __ が定義されているときは log は _ fpu ユ og 
の別名となる。また ， --DIRECT JFPU — が定義されているときは log は _ f — log の別 
名となる。 

数値演算コプロセッサの場合のみ， ERANGE が設定される。 

規 格 —— Project LIBC Group, ANSI C, POS1X.1 、 XPG3, AES/OS ， 4.3BSD, 
SYSV 


関連項目- exp , isnan , loglO 
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loglO 


用 途一常用対数/叩 10 ( x ) を求める。 

書 瓦 - #include <math. h> 

double loglO (double x); 

#include <sys/xmath.h> 
double _f_loglO (double x); 
double _fe_loglO (double x); 
double _fpu_loglO (double x); 

解 説—— loglO 関数はズの常用対数（ログ）を求める。各関数はそれぞれ次のように動作 
する。 

•loglO 数値演算コプロセッサが使用できる場合は数値演算コプロセッ 

サを直接ドライブし，使用できない場合は FLOAT パッケージを 
呼び出す 

• _ f_loglO 数値演算コプロセッサ命令を直接ドライブする 

• _feJLoglO FLOAT パッケージを呼び出す 

• _ fpu_loglO I / O 数値演算コプロセッサを直接ドライブする 



戻り値——正しく値が求められた場合， loglO 関数は rr > 〇の範囲内でズの自然対数を返 
す 0 また，ズの値が x = 0だとオーバーフローを起こす 0 もしズが非数 （ NaN ) な 
らば，変数 errno にその原因を示す エラー コードを設定して同じく非数を返し， 
それ以外の エラーでは 変数 errno にその原因を示す エラー コードを設定して無限 
大を返す。 

• EDOM ズの値が非数，またはズの値が計算範囲外 

• ERANGE 計算結果が才ーバーフローした 


注 意—— 〈 math . h > を読み込む前に， __ DIRECT _ FLOAT __ が定義されているときは loglO は 

_ fe _ loglO の別名となり， __ DIRECT _ IOFPU __ が定義されているときは loglO は 
_ fpu _ loglO の別名となる。また， __ DIRECT _ FPU __ が定義されているときは loglO 
は _f JLoglO の別名となる。 

数値演算コプロセッサの場合のみ， ERANGE が設定される。 
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規 格 

関連項目 


Project LIBC Group，ANSI C, POSIX.l, XPG3, AES/OS, 4.3BSD， 
SYSV 

exp, isnan, log 
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longjmp 


用 途—大域ジャンプを実行する。 


書 式- #include < setjmp . h > 

void __volatile longjmp り mp_buf env , mt rval ); 

解 説 —— longjmp 関数は， setjmp 関数で jmp_buf 型の配列 ⑼V に記憶したジャンプボイ 

ントに大域ジャンプを行い，その結果，プログラムカウンタは⑼ v に記憶された 
ジャンプポイントに移る。一方ジャンプポイントでは， setjmp 関数が見かけ上 
の戻り値として rval を返すように見える。 

戻り値——なし 0 longjmp 関数は決して戻ってこず， ⑼ v で指定したジャンプポイントに実 
行を移す。 

注 意 —— setjmp 関数での戻り値 rvfl / は，記述した場合と longjmp 関数によって制御を移 

された場合とを区別する必要があるので，0以外の値でなくてはならない 0 rval 
に0を設定した場合は1とみなされる。 

envht, あらかじめ set jmp 関数によって環境を格納しておく必要がある。もし格 
納されていなかった場合，その動作は一切保証されない。 

longjmp 関数が実行され，ジャンプポイントの位置に戻った場合，レジスタに割り 
当てられた auto 型変数を除くアクセス可能なすべてのオブジヱクトは， longjmp 
関数が実行され たと きの値をもつ。 

setjmp 関数を実行した関数が return やその他の大域ジャンプなどによって，よ 
り上位（呼び出し元）の関数に戻ってしまった場合，その後で longjmp 関数によっ 
てジャンプポイントに戻ろうとしても，その動作は保証されない。 

シグナル処理中に発生した別のシグナルの処理の最中に longjmp 関数を実行した 
場合，すなわち入れ子になったシグナル割り込み処理からの longjmp 関数の動作 
は保証されない。 

規 格—— ANSI C, P0SIX.1，XPG3, AES/OS, 4.3BSD, SYSV 
関埋項目- setjmp , sigaction ， siglongjmp , sigsetjmp 
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■seek 


用 途—ファイルポインタの位置を再設定する。 

書式- # include <unistd.h> 

off_t lseek (int fildes , off_t offset , int whence ); 

解 説—— lseek 関数は， fildes で指定したファイルハンドルのファイルポインタの位置を再 
設定する。新しい位置は冰み⑼“で^^旨定された開始位置に， offset バ4 卜分のオフ 
セットを加算したものとなる。は次のマクロ値を取り，それぞれ開始位置 
を以下のように定義する。 

• SEEK—SET ファイルの先頭から計算する 

• SEEK-CUR 現在のファイルボインタの位置から計算する 

• SEEK_END ファイルの終端から計算する 

lseek 関数はファイルの先頭を越えることはできないが，終端を越えてファイル 
サイズを拡張することはできる。この場合，拡張された部分はすべて0で埋めら 
れる。 

戻り値一正常にシークできた場合はシーク後のファイルポインタの位置を返し，失敗した 
場合は一1を返して，変数 errno にその原因を示すエラーコードを設定する。こ 
のとき，ファイルポインタの位置は変更されない。 

• EBADF 不正な fildes を 指定した 

• EN0SPC デイスクがいっぱいである 

• ESPIPE シークできないファイルを指定した 

• EINVAL 不正なオフセットを指定した 

互換性——ファイルがテキストモードでオープンされている場合， read 関数や write 関数の 
戻り値を用いてファイルボインタを計算してはならない。必ず tell 関数を用い 
ること。 

規 格—— Project LIBC Group, P0SIX.1, XPG3, AES/OS, 4.3BSD, SYSV 
関連項目- open , tell 
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_main 


用 途 — プログラムのエントリールーチン。 


書 式- #include < sys/xstart . h > 

void __volatile _main ( void ); 


解 説一 _ main 関数は，プログラムをリンクしたときにデフォルトで設定されるエント 
リールーチンである。を使用しているプログラムは，すべてこのルーチン 
から実行が開始される。 

_ main 関数は特定の处理はせずに，そのまま- start 関数へ処理を移行させる。つ 
まり， lain 関数は HUPAIR 識別子，ライブラリのバージョン識別子を格納する 
ためにだけ存在する。 

_ main 関数の先頭から，+2八イトの位置から8バイトに HUPAIR 識別子が，続 
く12バイトにライブラリ識別子が設定されている。 

• HUPAIR 識別子 “# HUPAIR \0” 

•ライブラリ識別子 “# LIBC ??????\0” 

戻り値——なし。 Jnaiii 関数は決して戻ってこない。 



互換性一 _ main 関数の内部処理は 1(7 のものとはかなり異なり，既存のライブラリの 
うちで』 lain 関数を置き換える必要があるもの，たとえば cshwild ， jshwild , 
SX — Window プログラムなどとは共存させることができない。 

もしリンクして無理に共存させた場合，その動作およびそれによって引き起こさ 
れる結果は不定であり，一切保証されない。 


規 格- Project LIBC Group 

関連項目- _staxt 
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_mai«epath 


用 途——パスの各要素からパス名を構成する。 

書 式- # include < stdlib . h > 

void _makepath (char * path , const char * drive , const char * air , 
const char * fname , const char * ext ); 

解 説~ ^ jnakepath 関数は引数で指定されたパス名の各要素から完全なパス名を構成し， 
その結果を/7如 / z が指す領域に格納する。指定するそれぞれの引数の意味は，次 
のとおりである。 

• drive ドライブ名。たとえば “ A : ” など。もしドライブ名の区切り記号で 

あるコロンがない場合は自動的に加えられ，み加が NULL の場合は 
省略される 

• dir ディレクトリ名。たとえば “ foo / bar /” など。もし dir の最後にパ 

スの区切り記号である“/”や“¥”がない場合は自動的に加えられ， 
ゴ //* が NULL の場合は省略される 

• fname ファイル名。たとえば“ sample ” など抗張子を除いた部分。もし 

fname が NULL の場合は省略される 

• ext ファイルの拡張子。たとえば“ . c ” など。もし先頭にピリオドがな 

い場合は自動的に加えられ， evf が NULL ならば拡張子とピリオド 
は省略される 

戻り値 ■なし。 

注 意—— jnakepath 関数はパスの構成要素を組み合わせるだけである。それぞれの構成要 
素やその結果が，ファイル名として有効なものになるかどうかについてはチェッ 
クしない。 

規 格 —— Project LIBC Group，MS-C7.0 

関連項目- - fullentry , — fullpath，_splitpath 

変 更一従来では各引数に NULL ポインタが渡された場合，その部分を省略するように 

なっていたが，現在のではこれに加えて空文字でも省略するようにした。 
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—mode2dos 


用 途-ファイルモードを抗張 UNIX アクセスモードから DOS ファイルアトリビュー 

卜に変換する。 

舊式- #include < sys / xunistd . h > 

dosmode_t _ mode 2 dos (const mode_t mode ); 

解 説—— jnode 2 dos 関数は mo みで指定される拡張 UNIX アクセスモードを，以下の表 

にしたがって DOS ファイルアトリビュートに変換する。 


拡張 UNIX アクセスモード 

DOS ファイルアトリビユート 

S.IREAD 

true 

S.IWRITE 

not JD0S_IRD0NLY 

S—IEXEC 

JDOS.IEXEC or _D0S_IFDIR 

SJEFDIR 

J)0S_IFDIR 

S.IFREG 

_D0S_IFREG 

S_IFLNK 

_D0S_IFLNK 

S—IFV0L 

_D0S_IFV0L 

S.ISYS 

_D0S_ISYS 

S.IHIDDEN 

_DOS_IHIDDEN 

S-IEXBIT 

_D0S_IEXEC 


戻り値——変換した DOS ファイルアトリビュートを返す。 

注 意—— jnode 2 dos 関数はライブラリの内部関数なので，移植性を考慮するならば使用し 
ないこと。 

規 格- Project LIBC Group 


関連項目- _ mode 2 unix 
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—mode2umx 


用 途——ファイルモードを DOS ファイルアトリビュートから拡張 UNIX アクセスモー 

ドに変換する。 

書 式- #include < xunistd . h > 

moae_t _ mode 21111 ix ( dosmode_t attr ); 

解 説- _ mode 2 unix 関数は a / かで指定される DOS ファイルアトリビュートを，以下の 

表にしたがって拡張 UNIX アクセスモードに変換する。 


DOS ファイルアトリビュート 

拡張 UNIX アクセスモード 

_D0S_IRD0NLY 

(not S_IWRITE) or S_IREAD 

_D0S_IHIDDEN 

S.IHIDDEN 

_D0S_ISYS 

S_ISYS 

_D0S_IFV0L 

S_IFV0L 

_D0S_IFDIR 

S—IFDIR 

_D0S_IFREG 

S—IFREG 

_D0S_IFLNK 

S_IFLNK 

_D0S_IEXEC 

S_IEXBIT 


戻り値——変換した拡張 UNIX アクセスモードを返す。 

注 意—— jnode 2 unix 関数はライブラリの内部関数なので，移植性を考慮するならば使用 
しないこと。 

規 格- Project LIBC Group 

閨連項目 一 — _ mode 2 dos 
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malloc 


用 途ーメモリブロックを確保する。 

書 式- #include < stdlib . h > 

void *ma 丄丄 oc ( size_t size ;; 

解 説—— malloc 関数は企 e バイトのメモリ領域をヒープ領域から確保し，そのメモリ領域 

へのボインタを返す。 

また，確保されたメモリ領域の先頭アドレスはいかなるデータ型にでもキャスト 
可能なように， CPU 依存のアラインメントに調整される。 

戻り値——正常に確保できた場合はその領域へのポインタを返し，失敗した場合には NULL 
を返して，変数 erriio にその原因を示すエラーコードを設定する。 

• EN 0 MEM メモリが足りなくなつたか，または制限値に達した 

規 格 —— ANSI C 、 POSIX . l ， XPG 3, AES / OS ，4.3 BSD , SYSV 

関連項目- brk , calloc , free , rbrk , realloc , sbrk 
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max 


用 途一2つの最大値を求める。 

書 式- # include < stdlib . h > 

int max unt a , int b ); 

#include < sys / param . h > 
int MAX (int a , int b ); 

解 説—— max はとわを比較し，どちらか大きいほうの値を返す〇 max はマクロとして定 

義されるので，値として比較できる変数型であればなんでも比較することができ 
る。そのため，上記の int 型以外にもいくらでも組み合わせが考えられる。た 
だし，0とわの変数型が異なる場合は，キャストによる影響を考えなければなら 
ない。その場合， a とわのどちらの変数型にキャストしてから比較されるかは， 
ANSI (7 の規定およびコンパイラによる。 

戻り値一とわとを比較して，大きいほうの値を返す。もしとろの型が異なる場合，戻 
り値は大きいほうの値の変数型になる0 

注 意—— max はつねにマクロとして定義される。また， MAX はすべての面で max と同じで 

ぁる。 

規 格- Project LIBC Group 

関連項目- MIN，min 
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mblen 


用 途—1マルチバイト文字の構成バイト数を調べる。 


書 式- #include <stdlib.h> 

int mblen (const char *s, size_t n;; 


解 説—— mblen 関数は s で指定した領域の先頭の 《 バイトに含まれる 1 マルチバイト文字 

が，何バイトで構成されているかについて調べる。 

mblen 関数の動作は，ロケールの LCLCTYPE カテゴリによって変化する。もし現 
在の ロ ケールの 文字 コー ドが状態依存体系であれば，に NULL を指定すること 
で，シフト状態を初期化することができる。 


戻り値一 J が正しいマルチバイト文字を指している場合は，その構成バイト数を返し（ただ 
し mill 文字は0とする)。不正なマルチバイト文字を指していたり，《バイト以上 
のマルチバイト文字を指している場合は一 1 を返して，変数 errno にその原因を 
示す エラー コードを設定する。 

また S に NULL を指定した場合は，現在のロケールの文字コードが状態依存体系 
であれば0以外の値を，状態依存体系でなければ0を返す。 



• EINVAL J が不正なマルチバイト文字を指している 


注 意—— ZJBC は C ロケールしかサポートしていない。 

規 格 —— Project LIBC Group，ANSI C ， AES / OS ， SYSV 
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mbstowcs 


用 途——マルチバイト文字列を幅広文字列に変換する。 

書 式- # include < stdlib . h > 

size_t mbstowcs ( wchar_t * pwcs , const char * s , size 一 t n ); 

解 説—— mbstowcs 関数は s で指定されたマルチバイト文字列を幅広文字列に変換し，結果 

を/7州ぴが指す領域に格納する。変換は mill 文字に到達するか，《幅広文字を格 
納するまで行われる。 

変換はロケールの LC - CTYPE カテゴリに影響される。もし現在のロケールが状態 
依存体系の文字コードを用いていた場合，変換はシフト状態を初期化してから行 
われる。 

戻り値——変換して格納された幅広文字数（終端の null 文字は含まない）を返す。ただし，途 
中で不正なマルチバイト文字に出会った場合変換はそこで中止され，一1を返し 
て変数 errno にその原因を示すエラーコードを設定する。 

• EINVAL 変換中に不正なマルチバイト文字に出会った 

注 意一は C ロケールしかサポートしていない。 

規 格一 Project LIBC Group，ANSI C , AES / OS，SYSV 

関連項目- mblen ， mbtowc , wcstombs , wctomb 
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Chapter 1 一 C 標準関数ライブラリ 


mbtowc 


用 途— マルチバイ ト文字を幅広文字に変換する。 

書 式- #include < stdlib . h > 

int mbtowc ( wchar_t 本 pwc , const char * s , size_t n ); 


解 説一 mbtowc 関数はで指定された領域の先頭 《 バイトに含まれる1マルチバイト文字 
を幅広文字に変換し，結果を /7 VVC が指す領域に格納する。 


変換はロケールの LC — CTYPE カテゴリに影響される。もし現在のロケールが状態 
依存体系の文字コードを用いていた場合， S に NULL を指定することで，シフト状 
態を初期化することができる。 


戻り値—— J が正しい マルチ バイト文字を指している場合は，その構成バイト数を返す（ただ 
し null 文字は0とする）。不正な マルチ バイト文字を指していたり，《バイト以上 
の マルチ バイト文字を指している場合は 一 1を返して，変数 errno にその原因を 
示す エラー コードを設定する。 

また J に NULL を指定した場合は，現在のロケールの文字コードが状態依存体系 
であれば0以外の値を，状態依存体系でなければ0を返す。 



• EINVAL 変換中に不正なマルチバイト文字に出会った 


注 意—— L / BC は C ロケールしかサポートしていない。 

規 格一 Project LIBC Group , ANSI C ， AES / OS , SYSV 
関埋項目- mblen , mbstowcs , wcstombs , wctomb 
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ライブラリー第 2 部 


memccpv 


用 途一指定文字まで領域をコピーする。 

書式 - #include <string.h> 

void *memccpy (void *regionl, const void *region2, 
int c, size_t n); 

解 説 - memccpy 関数は/ * 级 / 〇バ 2 の指す領域から 《 バイト，あるいは最初に見つかったごま 

でを /^/ 洲 7 の指す領域にコピーする。 memccpy 関数は strcpy 関数とは異なり， 
null 文字を検出しても処理を中断しない。 c は，内部で int 型から unsigned char 
型に変換される。 

戻り値-へのポインタを返す。 

注 意一領域が重なっていた場合の動作は未定義である。また，作は/2バイトのデー 

夕を格納するのに十分な領域を指していなければならない。1文字は1バイトと 
なる。 

規 格—— XPG 3, AES / OS , SYSV 

関連項目- memcpy, memmove, strcpy, strncpy 
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memchr 


用 途一領域中から指定文字を検索する。 

僅 式- #include く string . h > 

void *memchr ^const void * region , int character , size_t n ); 

解 説- memchr 関数は/*级/(9«の指す領域から《バイトまで，で指定された文字 

を検索する 0 memchr 関数は stixhr 関数とは異なり， null 文字を検出しても処理 
を中断しない。 character は， 内部で int 型から皿 signed char 型に変換される。 

戻り値一領域中で最初に現れた Mar 奴仰/*へのポインタを返し，見つからない場合は NULL 
を返す。 

注 意- 1文字は1バイトとなる。 

規 格—— ANSI C ， XPG 3, AES / OS , SYSV 

関埋項目- strchr , strcspn , strpbrk , strrchr , strspn , strstr , strtok 
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ライブラリー第 2 部 


memcmp 


用 途——2つの領域の内容を比較する。 

僅 瓦 - #inc 丄 ude <string.il> 

int memcmp (const void *regionl,const void *region2, size 一 t n;; 

解 説—— memcmp 関数は， r 印 / 例/の 指す領域と 作が⑽ 2 の指す領域の内容を 《 バイト 比較 

する。 memcmp 関数は strcmp 関数とは異なり， mill 文字を検出しても処理を中断 
しない。 

戻り値——比較の結果，2つの文字列がまったく同じならば0を返す。異なる場合，その位 
置での/側の文字が/ * 级/⑽ 2側の文字よりも大きいならば正の値を，小さい 
ならば負の値を返す。 

注 意——1文字は1バイトとなる。 

規格 —— ANSI C , XPG 3, AES / OS , SYSV 

関連 r 貝目 - strcmp, strcoll, strncmp, strxfrm 
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memcpy 


用 途一領域をコピーする。 


書式- #include く string . h > 

void *memcpy 、void 本 regionl , const void * region 2, size_t n ); 

解 説- memcpy 関数は/*级の指す領域からバイトを， /* 從 / o / i 7 の指す領域にコピー 

する。 memcpy 関数は strcpy 関数とは異なり， null 文字を検出しても処理を中断 
しない。 

戻り値 - region 1 へのポインタを返す。 


注 意-領域が重なっていた場合の動作は未定義である。また ， regionl は n バイ V のデー 

夕を格納するのに十分な領域を指していなければならない。1文字は1バイトと 
なる。 

規 格 —— ANSI C ， XPG 3, AES / OS , SYSV 

関連項目 - memmove , strcpy , strncpy 
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memmove 


用 途一領域をコピーする。 

書 式'- # include 〈 string . h > 

void *memmove 、void * regioni , void * region 2, size_t n ); 

解 説- memmove 関数は/*级/ 0 / 12 の指す領域から《バイトを，の指す領域にコピー 

する。 men 皿 ove 関数は strcpy 関数とは異なり， null 文字を検出しても処理を中 
断しない。また memcpy 関数とは異なり， region 1ヒ の指す領域が重なっ 
ていても正しく コピーで きる。 

戻り値- region 1 へのポインタを返す。 


注 意—— region ! ( i , / 2 バイトのデータを格納するのに十分な領域を指していなければなら 
ない。1文字は1バイトとなる。 

規 格 —— ANSI C , AES / OS，SYSV 

関連項目- memcpy , strcpy , strncpy 
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memset 


用 途—領域を指定文字で埋める。 

書式 - #include〈string 上> 

void *memset (void 本 region,int character, size 一 t n；; 

解 説 - memset 関数は reg/ 例の指す領域から /2 バイトを， c/zflmc 妙で指定された文字で 

埋める。 memset 関数は strset 関数とは異なり， null 文字を検出しても処理を中 
断しない 0 characterH 内部で int 型から unsigned char 型に変換される。 

戻り値 - r 從/例 へのポインタを返す。 

注 意 - 1 文字は 1 バイトとなる。 

規 格 一 ANSI C, XPG3, AES/OS, SYSV 


関連項目 - memchr, memcmp, memcDV, memmove 






ライブラリー第 2 部 



用 途——2つの最小値を求める。 

書 式-# include < stdlib . h > 

mt mm ^mt a , mt b ); 

#include < sys / param . h > 
int MIN (int a , int b ); 

解 説—— min は a とみを比較し，どちらか小さいほうの値を返す。 min はマクロとして定 

義されるので，値として比較できる変数型であればなんでも比較することができ 
る。そのため，上記の int 型以外にもいくらでも組み合わせが考えられる。ただ 
し a と5の変数型が異なる場合は，キャストによる影響を考えなければならない。 
その場合， a とろのどちらの変数型にキャストしてから比較されるかは ， ANSI C 
の規定およびコンパイラによる。 

戻り値——とろとを比較して，小さいほうの値を返す。もし a とみの型が異なる場合，戻 
り値は小さいほうの値の変数型になる。 

注 意- min はつねにマクロとして定義される。また， MIN はすべての面で min と同じで 

ある。 


規 格- Project LIBC Group 

関連項目- MAX, max 
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mkair 


用 途—ディレクトリを作成する。 

書式- #mclude < sys/stat . h > 

int mkdir (const cnar * path , mode.t mode ); 

解 説—— mkdir 関数は/^淡で指定したディレクトリを作成する。作成されたディレクトリ 

のファイル モードは ， mode をプロセスのカレン ト ファイルマスクでマスク した 
値となる。ファイルモードについての詳細は， chmod 関数あるいは stat 関数を 
参照のこと。 

戻り値——正常に作成できた場合は0を返し，失敗した場合には 一1 を返して，変数 exrno 
にその原因を示すエラーコードを設定する。 


• EEXIST ディレクトリがすでに存在する 

• EN 0 ENT 不正なパス名を指定した 

• EN 0 SPC ディスクが いっぱい である 

• ER 0 FS リードオンリーファイルシステムである 

• EL 00 P シンボリックリンクのネストが深すぎるか，またはループしている 



規 格一 P 0 S 1 XA ， XPG 3, AES / OS ，4.3 BSD，SYSV 

関連項目- chmod , stat , umask 
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ライブラリー第 2 部 


mktemp 


用 途——テンポラリファイル名を作成する。 

書 式- # include < stdlib . h > 

char *mktemp (char ^ template ); 

解 説一 mktemp 関数はテンプレートをもとにユニークなファイル名を作る。 template に 

は固定のファイル名部分に，最大6つまでの“ X ”(置き換え対象文字）をつなげた 
テンプレート文字列を設定する。この置き換え対象文字列の部分は， mktemp 関 
数を呼び出した時点での現在時刻を数値化したもので置き換えられる。たとえ 
ば， mktemp 関数を呼び出した時点の時刻が 7482 であった場合，結果は次のよう 
になる。 

“/ tmp / fileXXXXXX ” — “/ tmp/f ile 007482” 

ただし置き換え対象となりうるのは，固定ファイル名の後ろの連続した“ X ”であ 
り，以下のような指定をしても，すべての“ X ”が変換されるわけではない。 

“/ tmp / fileXYZXYZXXX ” — “/ tmp / fileXYZXYZ 482” 

また， mktemp 関数は作成したファイル名が存在するかどうかをチヱックし，もし 
重なった場合は最も先頭にある“ X ”の部分を a , b , c ...の 順番で変化させる。 
ただし，この部分が z を越えてもユニークにならない場合はエラーとなる。 

戻り値——正常にファイル名を作成できた場合は化 mp / are を返し，失敗した場合は一1を 
返す。 

注 意-同じテンプレートを用いて連続して mktemp 関数を呼び出した場合は，ユニーク 

な名前にならない場合がある。 


規 格—— 4.3 BSD 
関連項目- tmpfile，tmpnam 
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mktime 


用 途——地域時間を暦時間に変換する。 


•rf iC - # inc 丄 ude ぐ time 上〉 

time_t mktime ^struct tm * timeptr ); 

解 説—— mktime 関数は，"爪印びが指す領域に格納されている tm 構造体によって表される 

地域時間を暦時間（エポックタイム）に変換し，その値を返す。 

変換にあたっては tm _ wday と tm _ yday は無視される。また，地域時間を協定世界 
時間に変換する際に， tm _ isdst の値によって変換が調整される。もし tm_isdst 
が正ならば，現在の日付に関係なく夏時間（サマータイム）が適用されているもの 
として，また0ならば適用されていないとして計算される。 tm _ isdst が負なら 
ば，夏時間が適用されるかどうかはタイムゾーンの設定による。 

mktime 関数は変換前に， tzset 関数を呼び出して地域時間情報を再計算する。変 
換後，決定された日時から tm . yday , tm . wday が再言十算される。 

戻り値——正常に変換できた場合は暦時間を返し，失敗した場合には一1を返して，変数 
errno にその原因を示すエラー コード を設定する。 

• EINVAL 不正な地域時間を指定した 

注 意——変換が失敗した場合，印かが指す領域の内容は破壊されることがある。また 

tm _ sec は閏秒を調整するために，〇から61まで設定することができる 0 

規 格一 ANSI C , POSIX . l ， XPG 3, AES / OS，SYSV 

関連項目- gmtime , localtime , time , tzset 
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ライブラリー第 2 部 


modT 


用 途——整数部と小数部にわける。 

書 式- # include < math . h > 

double modf (double x , double * iptr ); 

#include < sys / xmath . h > 

double _ f_modf (double x , double * iptr ); 
double _ fe_modf (double x , double * iptr ); 
double _ fpu_modf (double x , double * iptr ); 

解 説—— modf 関数は； c を整数部と小数部に分解し，整数部は柄/*が指す領域に格納し，小 

数部を返す。符号は整数部，小数部ともに； c と同じになる。各関数はそれぞれ次 
のように動作する。 


• modf 数値演算コプロセッサが使用できる場合は数値演算コプロセッ 

サを直接ドライブし，使用できない場合は FLOAT パッケージを 
呼び出す 

• _fjnodf 数値演算コプロセッサ命令を直接ドライブする 

• _fejnodf FLOAT パッケージを呼び出す 

• ^ pu_modf I / O 数値演算コプロセッサを直接ドライブする 


戻り値——正しく値が求められた場合は小数部の値を返す。もし； c が非数 （ NaN ) だった場合 
は，変数 erxno にその原因を示すエラーコードを設定して同じく非数を返す。 


• EDOM A ： の値が非数 


注 意一を読み込む前に， __ DIRECT _ FLOAT __ が定義されているときは modf 
は- fejnodf の別名となり， -_ DIRECT _ IOFPU __ が定義されているときは modf は 
_ fpujnodf の別名となる。また， __ DIRECT _ FPU __ が定義されているときは modf は 
_f _ modf の別名となる。 

規 格 —— Project LIBC Group，ANSI C , POSIX . l , XPG 3, AES / OS ，4.3 BSD ， 
SYSV 

関連項目- frexp , ldexp 
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nice 


用 途—カレントブロセスの優先度を変更する。 

省 式- #include < unistd . h > 

mt nice (mt mere ); 

解 説一 nice 関数はカレントプロセスの優先度に/を加算する。プロセスの優先度は 

0< x <2 xNZER 0-1 の値で，プロセスの起動時に自動的に NZERO が設定される。 

戻り値——正常に変更できた場合は，新しい優先度: r - NZERO を返し，失敗した場合には -1 
を返す。 

互換性—— Human 68 k はマルチタスクではなく，プロセス ID 優先度という概念がないの 
で， nice 関数がこれらの値に影響されることはない。また， ZJBC 内ではデフォ 
ルトの仮想ユーザ ID および仮想グループ ID を root と仮定しているため ， nice 
関数は何ら影響をおよぼさないとはいえ，変更は必ず成功する。 

規 格 —— Project LIBC Group , XPG 3, AES / OS ， 4.3 BSD ， SYSV 
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ライブラリー第 2 部 


offsetof 


用 途——構造体メンバのオフセットを求める。 

書 式- #include く stddef . h 〉 

int offsetof ( structure , member ); 

解 説—— offsetof は，打/* wcmre で指定した構造体の member メ ンバに対する構造体の内 

部オフセットを求める。 

戻り値ーオフセット値（正の値）を返す。 

規 格- ANSI C 
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onexit 


用 途——プロセス終了時に必ず呼び出される関数を登録する。 

書 式- #include く stdlib . li > 

onexit_t onexit ( onexit_t func ；; 

解 説—— onexit 関数は / w « c で指定した関数を，プロセスの終了時に呼び出される関数の 

リストに登録する。これら登録された関数は，プロセスが終了するとき（正常終 
了，異常終了を問わない）に，登録された順番とは逆の順番（つまり最後に登録し 
た順番）で呼び出される。 

プロセスの終了とは， exit 関数によるプロセスを終了， main 関数からの return ， 
abort 関数での終了，エラーによる強制終了などすベての場合を含む。なお登録で 
きる関数の数は，最大 ONEXIT _ MAX 個までである。 ONEXIT _ MAX は < limits . li 〉 に 
定義されている。 

戻り値——正常に登録できた場合は/を返し，失敗した場合には NULL を返して，変数 
errno にその原因を示すエラーコードを設定する 0 

• EINVAL すでに ONEXIT _ MAX 個の関数が登録されているので，これ以上登 



注 意—— onexit 関数は割り込みベクタを元に戻す，チップを制御するなど，後処理をせず 

に終了したのではシステムをパニックに陥れるような重要な処理を登録するのに 
使用するべきである。その他の一般的な処理については， atexit 関数を使用す 
るほうが望ま しい。 

互換性一 onexit 関数は， MS - C 7.0 なヒで [t atexit 関数と同じ意味で使用されており， 
のように重要な処理にかぎられたものではなく， LIBC の onexit 関数とは 
名前は同じだが別物と考えたほうがよい。そのため， onexit 関数を用いたプロ 
グラムとはやや互換性を失うので注意すること。 

規 格 —— Project LIBC Group , MS - C 7.0 

関連項目- abort , atexit , exit , sysconf 
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ライブラリー第 2 部 


open 


用 途——ファイルをオープンする。 


書 式- # include く fcntl . li > 

int open (const char * path , mt oflag , •••); 

解 説 —— open 関数は /? が/ z で指定したファイルをオープンし，ファイルハンドルを返す 0 
低水準入出力ではこのファイルハンドルを通して，すべての操作が行われる。 

オープン動作は〇片はで指定したオープンモードにしたがって行われ，ファイル 
の切り詰めや新規作成などが行われる。オープンモードは次に示した各値のうち， 
必要なものの論理和をとって指定する。 

• D _ RD 0 NLY ファイルを読み込み専用モードでオープンする。ファイルへの 

書き込みは行うことができない 

• 0. WR 0 NLY ファイルを書き込み専用モードでオープンする。ファイルから 

の読み込みは行うことができない 

• 0 -RDWR ファイルを読み書き可能モードでオープンする。ファイルへの 

書き込み，読み込みの両方を行うことができる 

• 0 -TEXT テキストモードでオープンする。ファイルへの書き込み/読み込 

みに対してつねに CRLF と LF の間の変換が行われる。 0_ TEXT ， 
0_ BINARY のどちらも指定しない場合は， 0_ TEXT がデフォルト 
となる 

• 0 .BINARY バイナリモードでオープンする。ファイルへの書き込み/読み 

込みはすべて Human 68 k と直接行われ，一切データの変換は 
行われない 

• 0 .APPEND 追加書き込みモードでオープンする。 0— WR 0 NLY や 0_ RDWR と 

いっしょ に指定すると，ファイ ルへの書 き込みはつねにファイ 
ルの 終端に対して追加される 

• 0 -CREAT open 関数はで指定したファイルが存在しない場合はエ 

ラーとなるが，このフラグを指定しておくとファイルが見つか 
らない場合に新規にファイルを作成するようになる。新規に作 
成されるファイルのファイルアクセスモードはの次に指 
定される mode _ t 型の引数 mode にカレントファイルマスクを適 
用した値で設定されることになる 

• 0 -EXCL 0- CREAT といっしょに指定すると，认で指定したファイルが 

すでに存在する場合には エラーと なる。その結果，つねに新規 
作成だけが行われるようになり，すでにあるファイルがある場 
合には破壊しないようにすることができる 
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• O-TRUNC 0— WR 0 NLY や 0_ RDWR といっしょに指定すると， path で指定した 

ファイルがすでに存在する場合にはそのファイルの内容を破棄 
し，サイズを0バイトに切り詰めるようになる 

戻り値——正常にオープンできた場合はファイルハンドルを返し，失敗した場合は一1を返 
して，変数 errno にその原因を示すエラーコードを設定する。 

• EEXIST path で指定したファイルと同名のファイルがすでに存在する 

• EISDIR デイレクトリである 

• EMFILE これ以上ファイルをオープンできない 

• ENOENT path で指定したファイルが存在しない 

• EN 0 SPC デイスクがいっぱいである 

• EINVAL 不正な 0 flag を 指定した 

• EL 00 P シンボリックリンクのネストかへ深すぎるか，またはループしている 


互換性——デフォルト状態ではテキストモードでオープンされるので， UNIX のようにテ 
キストモードとバイナリモードの区別がない処理系からプログラムを移植する場 
合には，明示的に 0_ BINARY を指定するか， setmode 関数でデフォルトのモード 
を変更しておくこと。 

規 格一 Project LIBC Group ， MS - C 7.0, ANSI C , POSIX . l ， XPG 3, AES / OS ， 
4.3 BSD , SYSV 

関埋項目- chmod , close , creat , dup , fcntl ， lseek , read ， umask , write 
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openair 


用 途——ディレクトリストリームをオープンする。 

書 式- # include < dirent . h > 

DIR *ouendir const char * name ); 

解 説—— opendir 関数は，⑽/狀の指すディレクトリをオープンしてディレクトリストリー 

厶を作成し，そのディレクトリストリームへのボインタを返す。 

戻り値 ——正常にディレクトリがオープンできた場合はディレクトリストリームの構造体の 
ポインタを返し，失敗した場合は NULL を返して，変数 errno にその原因を示す 
エラー コードを設定する。 

• EN 0 ENT ディレクトリが見つからない 

• EN 0 TDIR ディレクトリではない 

• EN 0 MEM メモリが足りなくなった 

注 意——オープンされた後に，そのディレクトリに新規作成されたファイルは対象にはな 

らない。操作対象にするためには再度オープンする必要がある。 

規 格- Project LIBC Group , POSIX . l , XPG 3, AES / OS 、4.3 BSD , SYSV 

関連項目- closedir ， readdir ， rewinddir , seekdir , telldir 
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PRAMREG 


用 途ーパラメータレジスタ渡しのためのレジスタを指定する。 

•rf it - #include <mterruDt . h > 

PRAMREG (int var , reg ); 

解 説—— PRAMREG はパラメータをレジスタ渡しで行うために， wzr に/*從で指定したレジ 
スタを割り当て，正しくコンパイルされるようにする。つまりここで指定したレ 
ジスタは，関数内部でのレジスタの退避/復帰の候補からはずされるため，外部 
関数とこのレジスタをとおして値をやりとりすることができるようになる。 

PRAMREG (_ a 6_ argument , " a 6"); 


注 意—— PRAMREG は変数の宣言を行うマクロなので，文法的に変数宣言を行える場所にし 
か記述することはできない。 

互換性-この機能は X68000 Programming Series #1 X68000 Develop . に付属する吉野 

氏が移植された GCC でしか使用することができない。移植性を考慮するならば 
使用しないこと。 

規 格- Project LIBC Group 

関連項目一 RETREG , SET-FRAME 
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orint 


用 途——コンソールに簡易フォーマットで文字列を出力する。 

書 式- # include < sys / xglob . h > 

void Drmt (const char * format , •••); 

解 説一 - print 関数は / wmar で指定されたフォーマットにしたがい，与えられた文字列/ 
データを直接，コンソールに出力する。このため，たとえ標準出力がリダイレク 
卜されても，必ず画面に出力することができる。 

/ brma / に指定するフォーマット文字列は printf 関数に似ているが，非常に簡略 
化されたものである。 - print 関数は / cm ? がで指定されたフォーマット文字列を 
画面に出力するが，途中で“ •/•<!”，“% s ”，“% x ” というフォーマット指定文字に出 
会うと，それに対応するデータを引数から取り出して表示する。 

フォーマット指定文字として使用できるのは次のとおり。 

• # /od 符号なし10進整数を表示する 

• °/.x 符号なし16進整数を表示する 

• 7.S 文字列を左詰めで表示する 

戻り値——なし。 

注 意—— - print 関数はライブラリの内部関数なので，移植性を考慮するならば使用しない 
こと。 

規 格- Project LIBC Group 

関連項目- fprintf , printf 
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pathconf 


用 途——パス名に関する情報を取り出す。 


僅 式 - #inc 丄 ude < unistd . h > 

long pathconf ^const char * path , int name ；; 


解 説—— pathconf 関数は加 / z で指定したパスに関連する情報を取得し，ユーザアブリ 

ケーシヨンに対して現在のシステム設定値などを得る手段を与える。どの設定値 
を調べるかは⑽ me で指定する。⑽ we に指定することができるマクロ値と求め 
る設定値の一覧は次のとおり。 


• _ PC _ LINK_MAX 

• _ PC _ MAX_CANNON 

• JPC _ MAX_INPUT 

• _ PC _ NAMEJ 1 AX 

• JPC _ PATH_MAX 

• _ PC_PIPEJBUF 


ハードリンクの最大値（参考値） 

端末の Canonical 入力の最大バイト数（参考値)〇 
p が/!は端末デバイスを指していなければならない 
端末の入カキューの最大バイト数（参考値 )。 path 
は端末デバイスを指していなければならない 
ファイル名に許される最大の長さ（ただし null 文 
字は含まない） 

パス名に許される最大の長さ（ただし null 文字は 
含まない） 

パイブバッファの最大八イト数 （ L /5 C 1 では疑似パ 
イプしかサボートされていないので参考値にすぎ 


ない） 

• JPC.CHOWNJRESTRICTED chown 関数の使用が制限されているかどうか 


( L / BC では chown 関数は必ず成功するので無制限） 

• JPCJJO_TRUNC NAME _ MAX よりも長いファイル名を適正な長さまで 

切り詰めるかどうか （ L / 忍 C では一切考慮していな 
いので，切り詰めはない） 

• _ PC_VDISABLE ® 末の特殊文字を無効にすることができる文字（参 

考値)。 par / z は端末デバイスを指していなければ 
ならない 



戻り値——正常に制限値を取得できた場合はその値（無制限ならば一 1) を返し，失敗した場 
合には 一 1を返して，変数 errno にその原因を示すエラーコードを設定する。 

• EINVAL 不正な似 we を指定したか，または爪 zme に関する制限値が求め 

られない 

• ENOENT 存在しないファイル名を指定した 
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• ELOOP シンボリックリンクのネストが深すぎるか，またはループして 

いる 


互換性—— L 仿 C では上記（詳細は 〈 limits . を参照のこと）の制限値は可変ではなく，す 
ベて固定である。 

規 格—— POSIX . l ， XPG 3, AES / OS，SYSV 

関連項目- fpathconf , sysconf 
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pause 


用 途ーシグナルを受信するまでプロセスの実行を中断する。 

書式- #mclude く 皿 istd . h 〉 

mt pause 、 void ) ; 

解 説一 pause 関数は，カレントプロセスに対してシグナルが配信されかつそのシグナル 

が無視されずにユーザ定義のシグナルハンドラが起動されるか，あるいは強制的 
に停止させられるまでカレントプロセスの実行を中断する。 

戻り値ーシグナルが配信されるまで永遠に実行を中断するので，正常に処理を完了するこ 
とはない。シグナルによって处理を再開した場合には 一1 を返して，変数 errno 
にその原因を示す エラーコード を設定する。 

• EINTR シグナルによって割り込まれた 

規 格 —— Project LIBC Group ， POSIX . l 、 XPG 3、 AES / OS , 4.3 BSD，SYSV 

関連項目' ~~- sigaction , signal , sigsuspend 
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perror 


用 途——標準出力にエラーメッセージを出力する。 

書 式- #include <stdio . h > 

void perror (const char * s ); 

解 説- perror 関数は，その時点での変数 errno の値に対応するエラーメッセージを標 

準出力に出力する。その際，もし J が NULL でなくかつ S が指す文字列が空文字 
列でなければ，エラーメッセージの前に，とコロンと スペースを 付加した文字 
列を出力する。 

また変数 errno からエラーメッセージへの変換は， strerror 関数を用いて行わ 
れる。たとえば変数 errno が EN 0 ENT のときは，に sample を指定して perror 
関数を呼び出すと，結果として以下の文字列が出力される。 

sample: File or directory not found. 

戻り値-なし。 

規 格 —— ANSI C ， POSIX . l , XPG 3、 AES / OS ，4.3 BSD，SYSV 

関連項目- strerror 
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用 途一累乗パを求める。 

書 式- #include < math . h > 

double pow (double x , double y ); 

解 説 —— pow 関数は累乗 W を求める。 

戻り値——正しく値が求められた場合， pow 関数は a : >0の範囲でその値を返す。もしズが 
非数 ( NaN ) ならば，変数 errno にその原因を示すエラーコードを設定して同じく 
非数を返す。 

• EDOM の値が非数，またはズの値が計算範囲外 

注 意——つねに FLOAT パッケージを呼び出す。 

規 格一 Project LIBC Group, ANSI C, POSIX.l, XPG3, AES/OS, 4.3BSD, 

SYSV 

関連項目- exp , isnan ， log , 10 glO 
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printT 


用 途——標準出カファイルストリームにフォーマツト出力を行う。 

書 式- # include く stdio . h 〉 

int printf (const char * format , •• •ノ； 

解 説—— printf 関数は， / orm がで指定したフォーマツト文字列にしたがって引数を文字 

列に変換し，結果を標準出力に割り当てられたファイルストリームに出力する。 

フォーマツト文字列の指定方法や詳細な説明については， fprintf 関数を参照の 
こと。 

戻り値一正常に出力できた場合は出力した文字数を返し，失敗した場合は EOF を返してス 
ト リームの エラー指示子を設定する。失敗した場合は，変数 errno に その 原因を 
示す エラーコードを 設定する。 

• EBADF ファイルス トリ ームに関連するファイルハンドルがおかしい 

規 格一 ANSI C ， POSIX . l ， XPG 3, AES / OS ，4.3 BSD , SYSV 
関連項目- eprintf , fprintf , sprintf 
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psignal 


用 途——標準出力にシグナルメッセージを出力する。 

書 式- #include <stdio . h > 

ffinclude < signal . h > 

void psignal (int sig , const char * s ); 

解 説—— psignal 関数は，晻で指定したシグナルに対応するメッセージを標準出力に出力 

する。その際，もし *5 が NULL でなくかつ J かオ旨す文字列が空文字列でなければ， 
エラー メッセージの前に， J とコロンと スペースを付加した文字列を出力する。 

また sig からシグ十ルメ ッセージへの変換は， strsignal 閨数を用いて行われる。 
たとえば sig が SIGINT のときは， S に sample を指定して psignal 関数を呼び出 
すと，結果として以下の文字列が出力される。 

sample : SIGINT Interrupted 


戻り値-なし。 

規 格一 Project LIBC Group , 4.3 BSD 


関連項目- strsignal 
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用 途——ファイルストリームにバイトデータを出力する。 

書 式-# include <stdio . h > 

int putc (int c , FILE * stream ); 

解 説一 putc 関数は打/•似 m で指定されたファイルストリームに対して，文字ごを 

unsigned char 型に変換して出力する。これに応じて，ストリームのファイ 
ルポインタは1バイト進む。なお，ストリームが追加モードで才ープンされてい 
る場合，出力はすべてファイルの最後尾に追加される形で行われる。 

putc 関数は更新モードで正しく動作しない点を除けば， fputc 関数と同じである。 

戻り値——正常に出力できた場合は C を返し，何らかの エラーに よって失敗した場合はスト 
リームのエラー指示子を設定して EOF を返す0失敗した場合は，変数 errno にそ 
の 原因を示す エラーコー ドを設定する。 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

• EN 0 SPC ディスタがいっぱいである 

注 意-通常， putc 関数はマクロとして定義されるが， __ N 0_ STDI 0_ INLINE __ が定義され 

た場合は実体をもつ関数となる。 putc 関数がマクロとして展開される場合は，引 
数が副作用を伴わないように注意すること。 

規 格- ANSI C , POSIX . l ， XPG 3, AES / OS ，4.3 BSD , SYSV 

関連項目- fputc 
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putch 


用 途ーコンソールへ直接1文字を出力する。 

書式- #mclude < conio . h > 

int putch unt c ); 

解 説—— putch 関数は， c で指定した文字をコンソールに直接表示する。 putch 関数は，機 
能的には putchar 関数と似ているが， stdio ライブラリによるバッファリングの 
作用は一切受けない。 

また出力はつねにコンソールに対して行われるので，標準出力/標準エラー出力な 
どの状態に左右されることもテキスト/バイナリモードの区別もないので ， CRLF 
を LF に変換する作業も行われない。 

戻り値一 c を返す。 エラーは ない。 

規 格 —— Project LIBC Group , MS - C 7.0 
関連項目- cprintf , cputs , fputc , putc , put char 
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putchar 


用 途一標準出カファイルストリームにバイトデータを出力する。 

書 式 - #include <stdio.h> 

int putchar (mt c); 

解 説一 putchar 関数は標準出力に割り当てられたファイルストリームに対して， 文字 c 

を unsigned char 型に変換して出力する。これに応じて，ストリームのファイ 
ルポインタは1バイト進む。なお，ストリームが追加モードで才ープンされてい 
る場合，出力はすべてファイルの最後尾に追加される形式で実行される。 

putchar 関数は更新モードで正しく動作しない点を除けば， fputc 関数に stdout 
を指定した場合と同じである。 

戻り値——正常に出力できた場合は c を返し，何らかの エラーに よって失敗した場合は，標 
準出カストリームのエラー指示子を設定して EOF を返す。失敗した場合は，変数 
errno にその原因を示す エラーコード を設定する 0 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

• EN0SPC ディスクがいっぱいである 

注 意——通常， putchar 関数はマクロとして定義されるが， __N0_STDI0_INLINE__ が定義 

された場合は実体をもつ関数となる。 putchar 閨数がマクロとして展開される場 
合は，引数が副作用を伴わないように注意すること。 

規 格- ANSI C , POSIX.l，XPG3, AES/OS, 4.3BSD, SYSV 

関連項目 - fputc, putc 
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putenv 


用 途一環境変数を登録/変更/削除する。 

僅 式- #include < stdlib . h > 

int putenv (const char * string ); 

解 説一 putenv 関数は功*/叹で指定した環境変数を，プロセスの環境変数テーブルに対し 

て登録，変更あるいは削除する。ここで，於/*/叹は次の形式をとる。 

u name ^ va 丄 ue ” 


• 似/脱で指定した環境変数が環境変数テーブルにない場合は， 新たに name 
という名前で環境変数を登録し，その値として Vfl — を設定する 
• 似脱で指定した環境変数が環境変数テーブルにすでに存在している場合は， 
その環境変数の値を⑽/狀で置き換える 
• m /狀が空文字列だった場合，すなわちが /7>2 g が“=”で終わっている場合は 
環境変数テーブルから name という名前の環境変数を削除する 


戻り値——成功した場合は0を返し，失敗した場合には〇以外の値を返して，変数 errno に 
その原因を示すエラーコードを設定する。 

• EN 0 MEM メモリが足りなくなった 



注 意——操作される環境変数テーブルはプロセス内部にコピーされた環境変数テーブルで 

あり，親プロセスの環境変数テーブルや Human 68 k の環境変数テーブルは変更 
されない。 

putenv 関数を実行すると変数 environ が変化するため，以前のボインタ値に対 
するアクセスは保証されない。また， L 仿 (7 のなかには環境変数を参照する関数 
もあるが，参照がどの時点で行われるかは関数によるので，必ずしもクリアする 
ことによって影響を受けるとは限らない。 

規 格—— Project LIBC Group 、 XPG3 、 SYSV 


関連項目- clearenv , environ，getenv 


241 






ライブラリー第 2 部 


puts 


用 途——標準出カファイルストリームに文字列を出力する。 

書 式-# include く stdio.h 〉 

int puts ^ const char *s); 

解 説一 puts 関数は標準出力に割り当てられたファイルストリームに対して，が指す文 

字列と改行文字を出力する。文字列は null 文字までとし，最後の null 文字は出 
力しない。なお，ストリームが追加モードでオープンされている場合，出力はす 
ベてファイルの最後尾に追加される形式で実行される。 

puts 関数は fpiits 閨数とは異なり，文字列の最後に改行文字を付加して出力 
する。 

戻り値一正常に出力できた場合は負ではない値を返し，失敗した場合は EOF を返してスト 
リームの エラー指示子を設定する。失敗した場合は，変数 errno に その 原因を示 
す エラーコード を設定する。 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

規 格一 ANSI C ， POSIX .1 、 XPG 3, AES / OS ，4.3 BSD，SYSV 
関運項目- ferror, fopen, fputs, putc 
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用 途-ファイルストリームにワードデータを出力する。 

書式- #include < stdio . h > 

int putw unt w , FILE * stream ;; 

解 説—— putw 関数は，价⑽爪で指定されたファイルストリームに対してワードデータ vv 

を出力する。ワードデータのサイズは int 型を表現する4バイトロングワードで 
あり，このサイズはマシンに依存する。また， putw 関数はファイルストリームに 
対してアラインメントの計算は行わない。なお，ストリームが追加モードでオー 
プンされている場合，出力はすべてファイルの最後尾に追加される形式で実行さ 
れる。 

戻り値——正常にワードデータを出力できた場合は〇を返し，失敗した場合は〇以外の値を 
返して，変数 errno にその原因を示すエラーコードを設定する。 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

• EN 0 SPC デイスクがいっぱいである 


互換性一では出カデータは2バイトショートワードだが，では本来の定義どおり 
4バイトロングワードとなっている。したがって， putw 関数を使用したプロダラ 
ムとは互換性を失う。 

規 格一 XPG3、 AES/OS， 4.3BSD, SYSV 



関連項目- fopen , fwrite , getw 
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/* 

** 任意の 2 つの文字列を比較するための比較関数の例 
** compare_str (.const void *datal,const void *data2); 
**1 番目の項目が大きければ正，逆なら負，等しければ 0 を返す。 
*/ 

11 it compare_str ^ const void *datal,const void *data2) 

{ 

const char ホ * si - (const chax **) datal; 
const char **s2 ~ (const char **) data2; 
return strcmp ( 本 si, *s2); 

> 


qsort 


用 途——配列をクイックソートによって整列させる。 

書 式- #include < stdlib . h > 

void qsort (void * base , size_t nmemb , size_t size , 

int (* compare ) (const void *, const void *)); 

解 説—— qsort 関数は M 從で 指定され た 配列を，クイックソートアルゴリ ズム によって 

ソート する。 配列は 5 a 從から 始まる nmemb 個の項目 （1 項目は size バイト） で 
あり，比較関数の仕様にしたがって正順にソートされる。 

qsort 関数はソートを実行するに当たり，必要に応じて任意の2項目を関数 
awipare を用いてその大小を比較する。で指定した関数は，与えられた 
2項目を任意のアルゴリズムで比較し，1つ目の項目のほうが大きければ正の値， 
2つ目の項目のほうが大きければ負の値を，等しければ0を返す必要がある。 

戻り値—— なし。 

注 意——ソートの結果，等しい値の項目が並ぶ順番は未定義であり，状況によって変化 

する。 

規 格—— ANSI C , P 0 SIX .1, XPG 3, AES / OS ，4.3 BSD，SYSV 

関連項目- bsearch 


• 比較関_数の例 


123456789012 

111 
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RETREG 


用 途——パラメータレジスタ渡しのためのレジスタを指定する。 

谱 式'— #mclude <interruDt .h> 

RETREG 、int var , reg ); 

解 説一 RETREG は戻り値をレジスタ渡しで行うために， va /* に r 印で指定したレジスタを 
割り当て，正しくコンパイルされるようにする。つまりここで指定したレジスタ 
は，閨数内部でのレジスタの退避/復帰の候補からはずされるため，外部関数と 
このレジスタを通して値をやりとりすることができるようになる。 

RETREG (_ a 6_ retvalue , " a 6"); 

注 意—— RETREG は変数の宣言を行うマクロなので，文法的に変数宣言を行える場所にし 
か記述することはできない。 

互換性-この機能は X68000 Programming Series #1 X68000 Develop . に付属する吉野 

氏が移植された GCC でしか使用することができない。移植性を考慮するならば 
使用しないこと。 

規 格- Project LIBC Group 

関連項目—— PRAMREG , SETJFEAME 
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ライブラリー第 2 部 


raise 


用 途——自プロセスに対してシグナルを発行する。 

書 式- # include < signal . h > 

int raise ^int sig ); 

解 説—— raise 関数は現在実行中のプログラム（自プロセス）に対して，你で指定したシ 

グナルを配信する。 

戻り値——正常にシグナルを発生できた場合は0を返し，失敗した場合には一1を返して，変 
数 errno にその 原因を示す エラー コードを設定する。 

• EINVAL 不正なシグナル番号处を指定した 

規 格 —— ANSI C, AES/OS, SYSV 


関連項目- kill , sigaction，signal 
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rand 


用 途——整数の乱数を生成する。 

書 式- #include <stdlib . h > 

int rand 、 void ); 

解 説—— rand 関数は 0< x < RAND _ MAX の範囲で整数の乱数を生成し，その値を返す。 

戻り値—— OSa ^ RAND _ MAX 範囲内の乱数を int 型で返す 0 

注 意——乱数シードに何も設定しない場合は，デフォルトとしてシードに1が用いられる。 

規 格 —— ANSI C，POSIX.l, XPG3, AES/OS, 4.3BSD, SYSV 
関連項目 dr and , random , srand , srandom 
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random 


用 途——整数の乱数を生成する。 

書 式- #include < stdlib . h > 

unsigned mt random ( void ); 

解 説—— random 関数は〇幺〇:乞 ULONG_MAX の範囲で整数の乱数を生成し，その値を返す。 

戻り値—— 0^ r ^ UL 0 NG_MAX 範囲内の乱数を unsigned int 型で返す。 

注 意——乱数シードに何も設定しない場合は，デフォルトとしてシードに1が用いられる。 

規 格一 ANSI C、POSIX.l、XPG3, AES/OS, 4.3BSD, SYSV 

関連項目- dr and , rand , srandom 
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rbrk 


用 途—ブレーク値をリセットする。 

書 式- #include く stdlib . h 〉 

mt rbrk ^ void ); 

解 説一 rbrk 関数は現在のブレーク値を，ヒープ領域が0バイトになるような値にリセッ 

卜する。 

ブレーク値に ついての 詳細な説明は brk 関数を参照のこと。 

戻り値——正常にブレーク値を変更できた場合は〇を返し，失敗した場合には_1を返す。 

規 格- Project LIBC Group , XC 

関連項目- chkml , sbrk , sizmem 
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read 


用 途—ファイルから読み込む。 

書 式- # include < unistd . h > 

int read tint fildes , char * buff , unsigned mt n ); 

解 説 —— read 関数は，ガゴ打で指定したファイルハンドルが指すファイルから 《 バイトを 

読み込み，そのデータを k /# が指す領域に転送する。ただし，読み込み中に何ら 
かのエラ ーが発生するかファイル終端に達すると， read 関数はその時点で読み込 
みを中断する。その結果，ファイルポインタは読み込んだバイト数だけ進む。 

もし読み込みを開始した時点で，すでにファイルの終端に達していた場合は0を 
返す。また，《が0だった場合は何も行わない。 

ファイルがバイナリモードでオープンされていた場合，読み込まれたデータはす 
ベてそのままに格納される。しかしテキストモードでオープンされていた場 
合は，データ中に含まれるすべての CRLF を LF に変換してから如#に格納する。 
したがって，格納したデータの長さが/2に満たない場合がある。 

戻り値——正常に読み込めたか途中でファイル終端に達した場合は，実際に読み込んで如# 
に転送したバイト数を返す。何らかの エラーに よって失敗した場合には 一 1を返 
して，変数 errno にその原因を示す エラー コードを設定する。 

«が0だったり，読み込む前にすでにファイル終端に達していた場合は，0を返す。 
• EBADF 不正な fildes を 指定した 

注 意一 bujfU t 結果を格納するだけの十分な大きさの領域を指していなければならない。 

規 格—— Project LIBC Group, POSIX.l, XPG3, AES/OS, 4.3BSD, SYSV 

関連項目- fcntl , lseek ， open , write 
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用 途-次のディレクトリストリームの内容を読み込む。 

•rf 式- #mclude < dirent . h > 

struct dirent *readdir (DIR * dirp ); 

解 説- readdir 関数は，ゴ //*/? の指すディレクトリストリー厶の次のェントリへのポイン 


夕を返す 0 dirent 構造体は次のとおり 0 


struct dirent \ 
ino_t d_ino; 


/* i-node 番号 */ 


char d_name [NAME.MAX + 1 ];/* ファイルネーム */ 


戻り値——正常にエントリが読み込めた場合はそのポインタを返し，ディレクトリの終わり 
に達するなど失敗した場合は NULL を返す。 

注 意——オープンされた後に，そのディレクトリに新規作成されたファイルは対象にはな 

らない。操作対象にするためには再度オープンする必要がある。 

規 格一 Project LIBC Group, POSIX.l, XPG3, AES/OS, 4.3BSD, SYSV 

関連項目- closedir , readdir , rewinddir , seekdir，telldir 

変 更——従来と現在の U 忍(:では dirent 構造体が非互換である。現在の dirent 構造体は 


次のとおり。 



struct dirent i 
ino_t d_ino; 
off_t d_size; 
mode_t d_mode; 
time_t d_time; 


/* i-node 番号 */ 

/* ファイルサイズ */ 

/* 拡張 UNIX ファイルモード */ 
/* 最終変更時間 */ 


char d_name [NAME_MAX + 1 ] ; /* ファイル名 */ 
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ライブラリー第 2 部 


readlinK 


用 途——シンボリックリンクファイルのリンク先を取得する。 

書 式-# include く dos . li > 

int readlink ^ const char * linkpath , 

char * namebui,int buflen ;; 

解 説—— readlink 関数は， linkpath で指定したシンボリックリンクファイルが指してい 
るリンク先ファイル (linkpath ファイルの中身) のパス名を求め，⑽/狀如/の指す 
buflen バイ トの領域に コピーす る。 

戻り値——正常にパスが求められた場合はリンク先のパスの長さ返し，失敗した場合は一1 
を返して，変数 exxno にその原因を示すエラーコードを設定する。 

• EINVAL 指定されたファイルがシンボリックリンクではない 

• ELOOP シンボリックリンクのネストが深すぎるか，またはループして 

いる 

• ENOENT 指定されたファイルが存在しない 

• ENOSYS 実体のパスが取得できないか，または lndrv が常駐していない 

• ERANGE ハ ♦ツ フア オー ハ •一 

注 意- readlink 関数の動作はすべて lndrv に依存するため， lndrv 以外のシンボリッ 

クリンクドライバでは使用することができない。また，将来 lndrv が変更された 
場合も動作しなくなる可能性がある。 

namebuf は， 最低でも叫/?⑼以上の大きさの領域を指していなければならない。 

規 格—— Project LIBC Group , AES / OS、SYSV 

関連項目- _ dos _ importlnenv , _ dos _ lfiles , _ dos _ symlink , symlink 
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realloc 


用 途ーメモリブロックを再確保する。 


書 式- #include < stdlib . h > 

void *rea •丄丄 oc (void * ptr , size_t size ); 


解 説一 realloc 関数は現在/ 7 びが指しているメモリ領域が， size バイ トの大きさになるよ 
うにメモリブロックのサイズを変更あるいは移動する。 

通常， malloc 関数や calloc 関数で確保されたメモリ領域は，指定されたバイト 
数よりやや大きなサイズをもっていることが多い。そのため，加がその余裕で 
吸収することができたり，現在のサイズよりも小さい場合はメモリ領域は移動せ 
ず，サイズだけが変更される。 

しかし余裕分だけでは吸収できなかったり，その場でメモリ領域を拡大できない 
ような場合は， realloc 関数は新しい場所に加バイト分の領域を確保し，現在 
のメモリ領域の中身をそっくりコピーすることで対処する。この場合，返される 
ボインタの値は/7びとは異なる。 

また，確保されたメモリ領域の先頭アドレスは，いかなるデータ型にでもキャス 
卜可能なように CPU 依存のアラインメントに調整される。 


戻り値——正常に変更できた場合はその領域へのポインタを返し，失敗した場合には NULL 
を返して，変数 errno にその原因を示すエラーコードを設定する。 


• EN0MEM メモリが足りなくなったか，または制限値に達した 

注 意一もしぬ^が現在のメモリ領域のサイズよりも小さい場合，縮小された部分（メモ 
リ領域の後ろから削られる）の内容は，暗黙のうちに破棄される。 

■に， malloc 関数や calloc 関数で確保したメモリ領域へのボインタ以外を指 
定した場合の動作は未定である。 



規 格一 ANSI C , POSIX . l , XPG 3, AES / OS , 4.3 BSD , SYSV 


関連項目—— brk , calloc , free ， malloc , rbrk，sbrk 
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remove 


用 途 ー ファイル/ディ レクトリを 削除す る。 

書 式 - # include <stdio . h > 

int remove (const char * path ); 

解 説 一 remove 関数は/ 7 が /z で指定したパス名を削除する。もしパス名が通常ファイルな 

らば remove 関数は unlink 関数を呼び出し，ディレクトリならば rmdir 関数を 
呼び出す。 

戻り値 ——正常に削除できた場合は 〇 を返し，失敗した場合には一1を返して，変数 errno 
にその原因を示す エラーコード を設定する。 

• ENOTEMPTY ディレクトリが空ではない 

• EN0ENT 指定したパス名が見つからない 

• EL00P シンボリックリンクのネストが深すぎるか，またはループして 

いる 

• EDEVFS 指定したパス名はデバイスである 

規 格 —— ANSI C, POSIX.l, XPG3, AES/OS, 4.3BSD, SYSV 
関連項目 - rmdir , unlink 
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rename 


用 途——ファイル名を変更する。 

書式- #include < stdio . h > 

mt rename (const cnar *o 丄 d , const char * new ); 

解 説一 rename 関数は， o / ゴの指すファイル名を呢 w の指すファイル名に変更または移動 

する。また，パス名がディレクトリを指している場合は，指定のハ。スにディレク 
トリを移動する。このとき從 w のディレクトリがすで存在する場合，このディレ 
クトリが空である場合に限り削除して， W ゴのディレクトリを移動する。 old は， 
既存のファイルまたはディレクトリのパス名でなければならない。 


戻り値——正常にファイル名の変更または移動ができた場合は0を返し，失敗した場合は_1 
を返して，変数 errno にその原因を示すエラーコードを設定する 0 


• EN 0 ENT 

• EXDEV 

• EINVAL 

• EN 0 TDIR 

• EISDIR 

• ENOTEMPTY 


ファイルカ ゞ 見つからない 


ファイルシステムが異なる 

のパスに〇/ゴのパスが含まれている 
フアイルがすでに存在する 


ディレクトリがすでに存在する 
デイレクトリが空でない 


注 意——ファイルおよびディレクトリの移動は，ファイルシステム（すなわちドライブ）を 

またがって行うことはできない。 

ディレクトリの移動は疑似的なハードリンクを使用して実現している。 

規 格一 Project LIBC Group，ANSI C ， POSIX . l , 4.3 BSD ， SYSV 


関連項目- _ dos _ link , _ dos.unlink 
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ライブラリー第 2 部 


rewind 


用 途——ファイル ス トリ ームの ファイルボイ ン タを先頭に戻す。 

書 式- #include く stdio . h 〉 

void rewind (FILE * stream ;; 

解 説—— rewind 関数は，打/^ tw で指定されたファイルストリームのファイルポインタを 

先頭に戻す。また，ストリームに設定されていた終端指示子とエラー指示子がク 
リアされる。 

戻り値——特に戻り値はないが，失敗した場合には変数 errno にその原因を示すエラーコー 
ドを設定する。 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

• EN0SPC デイスクがいっぱいである 

• ESPIPE ファイルストリームに関連するファイルはシークできない 

• EINVAL 不正なオフセットを指•定した 

規 格—— ANSI C ， P 0 SIX .1, XPG 3, AES / OS ，4.3 BSD，SYSV 

関連項目- fseek , fsetpos 
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rewindair 


用 途ーディレクトリストリームの位置を先頭に戻す。 

s 1 JX - #inc 丄 ude < dirent . h > 

int rewinddir (DIR * dirp ); 

解 説—— rewinddir 関数はゴ冲が指すディレクトリストリームの位置を，このディレクト 

リの先頭にリセットする。 

戻り値——位置を正常にリセットできた場合は0を返し，失敗した場合は一1を返して，変 
数 errno にその原因を示す エラーコー ドを設定する。 

• EPERM 不正なディレクトリストリームを指定した 

規 格 —— Project LIBC Group, POSIX.l, XPG3, AES/OS, 4.3BSD, SYSV 
関埋項目- closedir , readdir ， rewinddir , seekdir , telldir 
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rindex 


用 途——文字列中から指定文字が最後に現れる位置を検索する。 


書 式 - #include〈string 上〉 

char *rindex (const char *string, int character); 

解 説—— rindex 関数は价/呢が指す文字列中から，で指定された文字が最後に現 

れる位置を検索する。幼かぎ末尾の null 文字も検索の対象となりうる 。 character 
は，内部で int 型から char 型に変換される。 

戻り値—— 打 /7 _叹 中で最後に現れる c/wrac 泣 r へのポインタを返し，見つからない場合は NULL 
を返す。 


注 意-1文字は1バイトとなる。 

規 格—— 4 . 3 BSD 


関連項目 ■ —— memchr, strchr, strcspn, strpbrk, strrchr ， strspn, strstr, strtok 
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rmdir 


用 途ーディレクトリを削除する。 


書 式 -— #mclude < sys / stat . h > 

mt rmdir (const char * path ;; 

解 説一 rmdir 関数は/^从で指定したディレクトリを削除する。 

戻り値——正常に削除できた場合は0を返し，失敗した場合には 一1 を返して，変数 errno 
にその原因を示すエラーコードを設定する。 


• ENOTEMPTY 

• EN 0 ENT 

• EN 0 TDIR 

• ER 0 FS 

• EL 00 P 


ディレクトリが空ではない 

不正なパス名を指定した 

ディレクトリではない 

リードオンリーフアイルシステムである 

シンボリックリンクのネストが深すぎるか，またはループし 

ている 


規 格一 POSIX.l，XPG3, AES/OS, 4.3BSD，SYSV 
関連項目- mkdir , remove，unlink 
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SET FRAME 


用 途—フレームポインタに使用するレジスタを指定する。 

書式- #include く inter nipt . h > 

SET_FEAME (int var , reg ); 

解 説—— SET_FRAME は var に/*印で指定したレジスタを，関数内部のスタックフレームの 

フレームポインタに指定し，正しくコンパイルされるようにする。 

SET.FRAME (" a 5") ; 

注 意—— SETJFRAME は変数の宣言を行うマクロなので，文法的に変数宣言が行える場所に 
しか記述することができない。 

互換性——この機能は X 68000 Programming Series #1 X 68000 Develop . に付属する吉野 
氏が移植された GCC でしか使用することができない。移植性を考虛するならば 
使用しないこと。 

規 格- Project LIBC Group 


関連項目—— PRAMREG , RETREG 
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SDlitoath 


用 途—パスを構成要素に分解する。 

書 式- #include < stdlib . h > 

void _splitpath (const char * path , char * drive , char * dir , 
char * fname , char * ext ); 

解 説—— _ S plitpath 関数は，が /z で指定されたパスをそれぞれの構成要素に分解し，そ 
の結果を引数で指定された領域に格納する。それぞれの引数の意味は次のとおり 
である。 

• drive ドライブ名。たとえば “ A :” など。もし/认にドライブ名がなけれ 

ば空文字列が入る 

• dir ディレクトリ名。たとえば“ foo/bar/” など。も し path にデイレ 

クトリ名がなければ空文字列が入る 

• fname ファイル名。たとえば“ sample ” など拡張子を除いた部分。もし 

path にファイル名がなければ空文字列が入る 

• ext ファイルの拡張子。たとえば“ . c ” など。もし/^ /z に拡張子がなけ 

れば空文字列が入る 

戻り値——なし。 

注 意—— _splitpath 関数はパスの構成要素を文字的に分解するだけであり，それぞれの 

構成要素が有効なものになるかどうかについてはチェックしない。 

規 格一 Project LIBC Group，MS-C7.0 

関連項目- jfullentry , _ fullpath , _makepath 
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途——プログラムの実行開始処理を実行する。 


式- ~~# include < svs / xstart . h > 

void __volatile _start ^struct _mep * mp ); 

説—— . start 関数は，プログラムの実行に必要なライブラリやシステムに関するすべ 
ての初期化を行い，正しくプログラムをセットアップする。具体的に， - start 関 
数は以下のような処理を行う。 

• Human 68 k から実行された直後，カレントプロセスは割り当て可能なすべ 
てのメモリが与えられている。 _ start 関数はこのメモリ空間をスタック領 
域，ヒープ領域などの論理的なブロックに分け，余ったメモリ空間をシステ 
ムに返却する 

• Human 68 k から渡されたコマンドラインを解析し （ HUPAIR エンコードの展 
開も含む)，引数配列を作成する 

• プロセス独自の環境変数エリアを作成し，そこに現在の環境をすべてコピー 
する。以後，環境エリアに対する操作はすべてこのコピー領域に対して行わ 
れる 

• スタックポインタを設定し，カレントプロセス内部のスタック領域を使用す 
るように手配する 

• CPU タイプやコプロセッサの有無を判定し，内部の演算処理を変更するフラ 
ダを立てる 

• カレントプロセスの実行開始時間を記録し，後で clock 関数によって経過時 
間が求められるようにする 

• システム制限値を取り込み，それを用いてライブラリ内部を初期設定する 

• 標準入出力などの最初からオープンされている低水準ファイルハンドルをラ 
イブラリ内部に取り込み，正しく処理できるようにする 

• 同じく標準入出力などの最初からオーブンされている高水準ファイルスト 
リームをライブラリ内部に取り込み，正しく処理できるようにする 

• シグナル処理や例外処理，タイマ処理を行うために必要な DOS や IOCS の 
ベクタを書き変え，処理を変更する 

• C ++ のグローバルコンス トラクタを プログラム 領域から検索して呼び出す 


- start 関数は以上のような処理を行った後，メインルーチンである main 関数を 
呼び出し， ユーザ プログラムの実行を開始させる。 





戻り値——なし。 - start 関数は決して戻ってこない。 


Chapter 1— C 標準関数ライブラリ 


互換性一 - start 関数の内部処理は XC のそれとはかなり異なっており，既存のライブラリ 
のうちで _ main 関数を置き換える必要があるもの，たとえば cshwild ， jshwild , 
SX - Window プログラムなどとは共存させることができない。 

もしリンクして無理に共存させた場合，その動作およびそれによって引き起こさ 
れる結果は不定であり一切保証されない。 

規 格- Project LIBC Group 

関連項目- - dos - setblock ，_ dos . super , environ , _ iocs _ ontime , _main 
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sysroot 


用 途——環境変数 “ SYSR 00 T ” を用いてパス名を再構成する。 

書 式-# include < sys / xglob . h > 

char *_sysroot (char * buff , const char * path , size_t n ); 

解 説—— -sysroot 関数は，卵淡で指定されたパス名と環境変数 SYSROOT から得られた 
ルートディレクトリのパス名を結合し，その結果をが指すバイトの領域に 
格納する。ただし，環境変数 SYSROOT が未定義の場合は，単純に/7がゐをコピー 
したものを返す。 

たとえば，環境変数 SYSROOT が“ A : / root ” に設定されていた場合， path に 
“/ etc / passwd ” を指定すると，結果は次のようになる。 

“ A :/ root / etc / passwd ” 

ここで- sysroot 関数は，環境変数 SYSROOT の値と/^ /z を結合し，その結果のパ 
ス名が正しくなるように，パス区切り記号を加えたり取り除いたりする。 

戻り値——正常に処理できた場合は如#を返し，失敗した場合は NULL を返して，変数 errno 
にその原因を示す エラーコード を設定する。 

• ERANGE 結果のパス名が《バイトより長い 

注 意—— buff は， 結果のパス名を格納するだけの十分な大きさの領域を指していなければ 

ならない。 

— sysroot 関数はライブラリの内部関数なので，移植性を考慮するならば使用し 
ないこと。 

規 格- Project LIBC Group 

関連項目- getenv 
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sbrk 


用 途ーブレーク値を変更する。 

書 式- #include く stdlib . h 〉 

void *sbrk (mt mere ); 

解 説—— sbrk 関数は，現在のブレーク値を今よりも / m 於バイトだけ大きくあるいは小さ 

くする。ただしブレーク値は，正確に/バイト分増減するわけではなく， incre 
バイト以上変化したうえで，最も近いページ境界（ム仿(7では疑似的に4096バイ 
卜を ページ サイズとする）に整列される。ただし，ヒープ領域は決して0バイト 
未満にはならない。 

ブレーク値についての詳細な説明は brk 関数を参照のこと。 

戻り値——正常にブレーク値を変更できた場合は変更前のブレーク値を返し，失敗した場合 
には一1を返して，変数 errno にその原因を示す エラー コードを設定する 0 

• EN 0 MEM メモリが足りなくなったか，または制限値に達した 

規 格一 Project LIBC Group ， XC ，4.3 BSD , SYSV 
関連項目- brk , chkml , rbrk，sizmem 
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scam 


用 途——標準入カファイルストリームからフォーマツト入力を行う。 

書 式- #include <stdio . h > 

int scanf 、 const char * format , 

解 説一 scanf 関数は/ o / vrnzr で指定した入カフォーマツト文字列にしたがって，必要な 

データ列を標準入力に割り当てられたファイルストリームから乂力し，その結果 
を引数の指す領域に格納する。 

入カフォーマツト文字列の指定方法や詳細な説明については， fscanf 関数を参 
照のこと。 

戻り値——正常に入力できた場合は実際に入力できた項目数を返し，失敗した場合は EOF を 
返して，ストリームのエラー指示子を設定する。失敗した場合は，変数 errno に 
その原因を示す エラーコー ドを設定する。 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

注 意一引数に指定するボインタは，結果を格納するだけの十分な大きさの領域を指して 

いなければならない。 

規 格 —— ANSI C , POSIX . l , XPG 3、 AES / OS ，4.3 BSD、SYSV 

関連項目- fscanf , sscanf 
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seekdir 


用 途—ディレクトリストリームの位置を変更する。 

書式- frinc 丄 ude < dirent . h > 

mt seekdir (DIR * dirp , long location ); 

解 説一 seekdir 関数は，ゴか/?が指すディレクトリストリームの位置を bcation で指定さ 
れる位置に設定する。 

戻り値一正常に位置を設定できた場合は0を返し，失敗した場合は一1を返して，変数 
errno にその原因を示すエラーコードを設定する。 

• EN 0 ENT ファイルが見つからない 

• EPERM 不正なディレクトリストリームを指定した 

規 格—— Project LIBC Group ， POSIX . l , XPG 3, AES / OS , 4.3 BSD，SYSV 
関埋項目- closedir , readdir , rewinddir , seekdir , telldir 
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setbuf 


用 途——ファイルストリームにバッファを割り当てる。 

書 式- #include く stdio . li > 

void setbuf (FILE * stream , char *buf エノ； 

解 説—— setbuf 関数は，打；^ aw で指定したファイルストリームで使用するバッファ領域 

を設定する。通常，ファイルストリームをオープンすると自動的にフルバッファ 
リングモードでバッファが確保されるが， setbuf 関数を用いれば，そのバッファ 
を ユーザが 独自に変更できる。 

バッファは ガが NULL でなければ フルバッファ リングモードで， NULL ならば ノ 
ンバッファ リ ング モードで使用される。 

戻り値——なし。 

注 意—— buff {こ NULL 以外の値を指定するときは，如ガ'は少なくとも BUFSIZ バイトの領域 

を指していなければならない。なお， BUFSIZ はく stdio . h 〉 に定義されている。 

setbuf 関数で指定したバッファ領域は， fclose 関数によってファイルストリー 
ムをクローズしても自動的には解放されない。よって，ユーザが責任をもって処 
理する必要がある。 

setbuf 関数を呼び出すと，ストリームをオープンしたときに自動的に割り当て 
られたノヾッファ領域は解放される。 

setbuf 関数は バッファに データがない状態で実行する必要がある。つまり， ファ 
イルストリームをオープン/シーク/フラッシュした直後に実行しなくてはなら 
ない0 

規 格一 ANSI C ， POSIX . l ， XPG 3, AES / OS ， 4.3 BSD , SYSV 

関連項目- fclose ， fopen , setvbuf 
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setgid 


用 途ーグループ ID を変更する。 

書式 frinc 丄 ude < unistd . h > 

mt setgid kgid_t gid ); 

解 説 一 setgid 関数は， カレン トプロセスの実グループ ID や実効グループ ID を gid に 

変更する。 

戻り値一正常に変更できた場合は0を返し，失敗した場合には一1を返して，変数 erirno 
にその原因を示すエラーコードを設定する。 

• EINVAL 不正な g / ゴを指定した 

互換性一 Human 68 k にはユーザ ID やグループ ID の概念がないので， setgid 関数がこ 
れらの値に影響されることはない。また， ZJ 及 C 内ではデフォルトの仮想ユーザ 
ID および仮想グループ ID を root と仮定しているため， setgid 関数は何ら影響 
をおよぼさないとはいえ，変更は必ず成功する。 

規 格—— P 0 SIX .1， XPG 3, AES / OS ，4.3 BSD , 

関連項目- getgid，setuid 
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setgrent 


用 途—グループファイルへのアクセスをファイル先頭に戻す。 

書式-# include < grp . h > 

void setgrent ( void ); 

解 説- setgrent 関数は， getgrent 関数などでアクセス中のグループファイルのファイ 

ルポインタを先頭に戻す。 getgrnam 関数や getgrgid 関数のインタフ：！:イスを用 
いずにグループを検索する場合には，明示的に endgrent 関数によってアクセス 
を終了すること。 

戻り値-なし。 

規 格 —— Project LIBC Group ，4. 3 BSD , SYSV 
_連項目- endgrent , getgrent , getgrgid , getgrnam 
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setjmp 


用 途——大域ジャンプ用のジャンプポイントを設定する。 

書式- #mclude < setjmp . h > 

mt set ]mp ( jmp_buf env ); 

解 説—— setjmp 関数は呼び出された時点 （ジャンプポイント） での環境を， jmp _ buf 型の 

配列⑼ v に記憶する。この環境⑼ v は，後で lcmgjmp 関数に引数として与えると 
制御をジャンプポイントに移すことができる。 

戻り値——記憶を行った場合 setjmp 関数は0を返すが， lcmgjmp 関数によって制御が移さ 
れた場合は， longjmp 関数で指定した rvalim り値となる。この rva / は必ず〇以 
外の値をとるので，両者は区別することができる。 

注 意—— longjmp 関数によって正しく環境を復帰させるためには， setjmp 関数は以下に述 

ベる文脈にしか存在してはならない。それ以外の場合の動作は一切保証されない。 

•選択文 （ if ， switch ) か反復文 （ while , for , do while ) の制御式 
• 制御式中で，一方が i 凡整数定数式である関係演算子など非等号演算子のオペ 
ランド 

• 制御式中の！演算子のオペランド 
• 式中のすべての式。 void 型も可 


互換性一 ANSI 。では setjmp 関数はマクロとして実装されることが定められているが， 
1仿(7では関数として定義している。忠実にに合致させようとするなら 
ば， —setjmp 関数を作成し， setjmp は- setjmp 関数への別名定義にすればよい 0 

規格一 ANSI C , P 0 S 1 X .1， XPG 3, AES / OS 、 4.3 BSD，SYSV 

関連項目- longjmp , siglongjmp , sigsetjmp 
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setmode 


用 途——ファイルの変換モードを変更する。 

書 式- # include < unistd . h > 

int setmode (int fildes , mt mode ); 

解 説—— setmode 関数は，ガゴ打で指定したファイルハンドルのテキスト/バイナリ変換 
モードをみに変更する 0 W 0 みには次の値を指定することができる0 

• 0 -TEXT データ変換モードをテキストモードに変更する 

• 0 JBINARY データ変換モードをバイナリモードに変更する 

戻り値一正常に変更できた場合は変更前の変換モードを返し，失敗した場合には一1を返 
して，変数 errno にその原因を示すエラーコードを設定する。 

• EINVAL 不正な mode を 指定した 

• EBADF 不正な fildes を 指定した 

規 格一 Project LIBC Group ，MS - C 7.0 
関連項目- ere at , fmode，f open , open 
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setpgid 


用 途——プロセスグループ ID を変更する。 

書式- #mclude く unistd . li > 

int setpgid ( pid_t pid , gid_t pgid ); 

解 説一 setpgid 関数は， /?/ ゴで指定したプロセスのプロセスグループ ID を pgid に変更 

する。 

戻り値——正常に変更できた場合は0を返し，失敗した場合には一1を返して，変数 errno 
にその原因を示す エラー コードを設定する。 

• EINVAL 不正な pgid を 指定した 

• ESRCH 不正な/?/ゴを指定した 

注 意—— setpgid 関数は，カレントプロセス以外のプロセスに対しては実行できない。す 

なわち pid には， 必ず getpid 関数で求めた値を指定する必要がある。 

互換性—— Human 68 k にはプロセス ID や ユーザ ID ， グループ ID の概念がないので， 
setpgid 関数がこれらの値に影響されることはない。また，内ではデフォル 
卜の仮想 ユーザ ID および仮想グループ ID を root と仮定しているため ， setpgid 
関数は何ら影響をおよぼさないとはいえ，変更は必ず成功する。 

規 格—— POSIX . l , XPG 3, AES / OS , 4.3 BSD、SYSV 

関連項目- getpgrp , getpid , setsid 
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setpwent 


用 途——パスワードファイルへのアクセスをファイル先頭に戾す。 

書 式- # include < pwd . h > 

void setpwent ( void ); 

解 説- setpwent 関数は， getpwent 関数などでアクセス中のパスワードファイルのファ 

イルポインタを先頭に戻す。 

getpwnam 関数や getpwuid 関数のインタフヱイスを用いずにユーザを検索する 
場合には，明示的に endpwent 関数によってアクセスを終了すること0 

戻り値——なし。 

規 格一 Project LIBC Group , 4.3 BSD，SYSV 
関連項目- endpwent ， getpwent , getDwnam , getpwuid 
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setrlimit 


用 途—システム制限値を再設定する。 

書式- #mclude < sys/resources . h > 

mt setrlimit ^int resource , struct rlimit * rlp ); 

解 説—— setrlimit 関数は現在の環境における/*打⑽ rce で指定したシステム制限値を， r //? 

で指定した値に再設定する。には次の値を指定することができ，再設定 
は以下のようにして行われる。 


• RLIMIT.CPU 

CPU 消費時間は再設定不可 

• RLIMITJSIZE 

最大ファイルサイズは再設定不可 

• RLIMIT_DATA 

ヒープ領域の最大サイズは正でかつ最大値以下ならば， 


再設定可能 

• RLIMIT_STACK 

スタック領域の最大サイズは再設定不可 

• RLIMIT_CQRE 

コアファイルの最大サイズは正でかつ最大値以下ならば， 


再設定可能 

• RLIMIT_RSS 

メモリ空間の最大サイズは再設定不可 

• RLIMIT-NOFILE 

最大オープンファイル数は再設定不可 


また， rlimit 構造体は次のとおり。 
struct r 丄 imit { 

int rlim . cur ; /* 現在の制限値*/ 

int rlim _ max ; /* 設定できる最大の制限値*/ 


戻り値——正常に設定できた場合は〇を返し，失敗した場合には一1を返して，変数 errno 
にその原因を示すエラーコードを設定する。 

• EPERM 値を再設定することができない 

• EINVAL 不正な resource を指定した 

規 格 —— Project LIBC Group , 4.3 BSD 

関連項目- getrlimit 
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setsid 


用 途——新しいプロセスグループ ID を形成する。 

書 式 - #include < unistd . li > 

int setsid ( void ); 

解 説—— setsid 関数はカレントプロセスを，プロセスグループのリーダーとした新しい 

セッションを形成する。 

戻り値一正常に変更できた場合は0を返し，失敗した場合には 一 1を返す。 

互換性—— Human 68 k にはプロセス ID やユーザ ID , グループ ID の概念がないので， 
setsid 関数がこれらの値に影響されることはない。また，ではデフォルト 
の仮想ユーザ ID および仮想グループ ID を root と仮定しているため， setsid 関 
数は何ら影響をおよぼさないとはいえ，変更は必ず成功する。 

規 格 一 POSIX .1 , XPG 3 y AES / OS 、4.3 BSD , SYSV 

関連項目- setpgid 
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setuid 


用 途ーユーザ ID を変更する。 

舊式- #include < unistd . h > 

int setuid ( uid_t uid ); 

解 説 —— setuid 関数は，カレントプロセスの 実ユーザ ID および 実効ユーザ ID を uid に 

変更する。 

戻り値——正常に変更できた場合は0を返し，失敗した場合には 一1 を返して，変数 eirno 
にその原因を示すエラーコードを設定する。 

• EINVAL 不正な W / ゴを指定した 

互換性—— Human 68 k にはユーザ ID やグループ ID の概念がないので， setuid 関数がこ 
れらの値に影響されることはない。また，ではデフォルトの仮想ユーザ ID 
および仮想グループ ID を root と仮定しているため， setuid 関数は何ら影響を 
およぼさない。とはいえ，変更は必ず成功する。 

規 格—— POSIX . l ， XPG 3, AES / OS ，4.3 BSD , SYSV 

関連項目- geteuid , getuid , setgid 
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setvbuf 


用 途 ——ファイルストリームにバッファを割り当てる。 

書 式- # include <stdio . h > 

int setvbuf (FILE * stream , char * buff , int type , size_t size ); 

解 説 - setvbuf 関数は，で指定した ファイルストリ ー厶で使用するバッファ領域 

を設定する。以後，ファイルストリームは ㈣ ガが指す垃どバイトの領域を ， type 
で指定した バッファリング 方式で使用する。ただし，に NULL が指定された 
場合は， setvbuf 関数が自動的に size バイトの領域を害 I ]り当てる。 

type には以下のマク ロ値を指定する。 

• -IOFBF フルバッ ファ” ング方式 

• —IOLBF ラインバッファリング方式 

• -IONBF ノンバッファリング方式 

スト リームのバッファリング 方式が フルバッファリングの 場合， すべての 入出力 
は バイト分 メモリ 内に蓄えられ， バッファがいっぱい になった時点で実際に 
入出力が行われる。 

ラインハ♦ッファリングの場合，これに加えて改行文字に出会ったときに入出力が 
行われる。また出力の場合，ノンバッファリング/行バッファリングされているス 
トリーム（ほかのストリームも対象になる）に対して，入力要求が行われたときに 
も出力が行われる。 

一方ノンバッファリングの場合，すべての入出力はその場で行われ，メモリ内で 
蓄えられることも遅延されることもない。 

戻り値 ——正常に割り当てることができた場合は0を返し，失敗した場合には0以外の値を 
返して，変数 errno にその原因を示すエラーコードを設定する 0 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

• EINVAL 不正な type を 指定した 

注 意 —— buff に NULL 以外の値を指定するときは ， buff は少なくとも size バイト の領域を指 

していなければならない。 

setvbuf 関数で指定したバッファ領域は ， f close 関数によってファイルストリー 
ムをクローズしても自動的には解放され ない。 よって ユーザが 責任をもっ て 処理 
する必要がある。 
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setvbuf 関数を呼び出すと，ストリームをオープンしたときに自動的に割り当て 
られたバッファ領域は解放される。 

setvbuf 関数は バッファに データがない状態で実行する必要がある。つまり， ファ 
イルストリームを オーブン/シーク/フラッシュ した直後に実行しなくてはなら 
ない。 

規 格一 ANSI C, XPG 3 , AES/OS, SYSV 

関連項目- fclose , fopen , setbuf 
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sigaction 


用 途 ——シグナル発生時の動作を再設定または取得する。 

書式 - #include く signal . h > 

int sigaction (int sig , const struct sigaction * act , 
struct sigaction * oact ); 

解 説—— sigaction 関数は海で指定した番号のシグナルの シグナル 動作を，もし act が 

NULL でなければそれの値で再設定し，元の設定情報を⑽以が NULL でなければそ 
の領域へ格納する。 sigaction 構造体は次のとおり。 

struct sigaction t 

void (*sa_handler) (int); /* ハンドへのポインタ*/ 
sigset_t sa.mask; /* シグナル発生時のマスク*/ 

int sa_flags; /* シグナルフラグ*/ 

>； 

また，上記の各メンバの意味と値の設定方法は次のとおり。 

• saJiandler シグナルハンドラへの ポインタ。 signal 関数で設定するハン 

ドラと同じ 

• sajnask シグナルが発生すると，ライブラリはまずシグナルハンドラ 

が多重に呼び出されないように，当該シグナルをマスクする。 
そのとき，ここで指定されたシグナルマスクも同時に適用さ 
れる。この値を設定することで，当該シグナルが発生したと 
きに任意のシグナルマスクを加えることができる 

• sa_flags シグナル発生時の処理の仕方を制御する。もしここに 

SA _ RESETHAND が設定されている場合は，シグナルハンド 
ラが呼び出されるたびにシグナルハンドラ sa 上 andler は，デ 
フォルトの設定 （ SIG _ DFL ) に戻される。一般に 4.3BSD では 
シグナルハンドラはデフォルトに戻らず， 5 T 5 T では元に戻る 

シグナル動作に関する詳細な説明は， signal 関数を参照のこと。 

戻り値 ——正常に設定できた場合は0を返し，失敗した場合には 一 1を返して，変数 errno 
にその原因を示す エラーコード を設定する。 

• EINVAL 不正な Wg を指定したか，または SIGKILL 
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規格 —— P0S/X.1, XPG3, AES/OS，SYSV 

関埋項目 - kill, raise, sigaddset, sigblock, sigdelset, sigemptyset, sigfillset, 

sigismember, signal, sigprocmask, sigsuspend 
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sigaddset 


用 途——シグナルセットへの追加を実行する。 

書 式- # include < signal . h > 

int sigaddset ^sigset.t *set, mt signo); 

解 説一 sigaddset 関数は犯/が指す領域に格納されているシグナルセツトに， signoTm 

定したシグナルを追加する。 

戻り値——正常に追加できた場合は0を返し，失敗した場合には一1を返して，変数 errno 
にその原因を示す エラーコー ドを設定する。 

• EINVAL 不正なシグナル signo を 指定した 

注 意——货^が指すシグナルセットは，少なくとも1回は sigemptyset 関数あるいは 

sigfillset 関数によって初期化されている必要がある。 

通常， sigaddset 関数はマクロとして定義されるが， __ NO _ SIGNAL _ INLINE __ が定 
義された場合には実体をもつ関数となる。なおマクロ版の sigaddset 関数は，エ 
ラーチヱックを行わないので注意すること。 

規 格一 POSIX .1 ， XPG 3, AES / OS , SYSV 

関埋項目- sigaction , sigdelset , sigemptyset , sigfillset , sigismember , 

sigpending , sigprocmask ， sigsuspend 


282 






Chapterl — C 標準関数ライブラリ 


sigblock 


用 途——シグナルをブロックする。 

書式- #include く signal . h > 

int sigblock (int mask ); 

解 説—— sigblock 関数は masA : で指定されたシグナルマスクを，カレントシグナルマスク 
とし，当該シグナルが配信されるのを抑制する。ブロックされたシグナルが発生 
すると，そのシグナルはペンディングシグナルセツトに追加され，マスクが適切 
な値になったときに（解除されたときに)，あらためて配信される。 

戻り値——追加される前のシグナルマスクを返す。 

注 意- sigblock 関数は sigprocmask 関数の古い形のインタフヱイスである 0 したがっ 

て戻り値は sigset _ t 型ではなく， int 型となっている。 LffiC では sigset _ t 型 
は int 型と同じであるから問題ないが，移植性を考慮するならば ， sigprocmask 
関数のインタフェイスを用いるべきである。 

規 格一 Project LIBC Group , 4.3 BSD 

関連項目—— kill , raise , sigaction , sigaddset , sigdelset , sigemptyset , sigfillset , 
sigismember , signal ， sigprocmask ， sigsuspend 
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sigdelset 


用 途ーシグナルセットからの削除を実行する。 

書 式- # include < signal . h > 

int sigdelset ( sigset_t * set , int signo ); 

解 説—— sigdelset 関数は如が指す領域に格納されているシグナルセツトから， signo で 

指定したシグナルを削除する。 

戻り値一正常に削除できた場合は〇を返し，失敗した場合には 一1 を返して，変数 eixno 
にその原因を示す エラーコー ドを設定する。 

• EINVAL 不正なシグナル S を肋を指定した 

注 意-奶が指すシグナルセットは，少なくとも1回は sigemptyset 関数あるいは 

sigfillset 関数によって初期化されている必要がある。 

通常， sigdelset 関数はマクロとして定義されるが， __ NO _ SIGNAL _ INLINE __ が定 
義された場合には実体をもつ関数となる。なおマクロ版の sigdelset 関数は，エ 
ラーチヱックを行わないので注意すること。 

規格—— POSIX .1 、 XPG 3, AES / OS，SYSV 

関連項目- sigaction , sigaddset , sigemptvset , sigf illset , sigismemoer , 

sigpending , sigprocmask ， sigsuspend 


284 






Chapter 1— C 標準関数ライブラリ 


sigemptyset 


用 途ーシグナルセットの初期化を実行する。 

邊 式- #include く signal 上〉 

int sigemptyset ( sigset_t * set ); 

解 説- sigemptyset 関数は，^がが指す領域に格納されているシグナルセットを初 

期化する。 sigaddset 関数や sigdelset 関数などの操作を行う前には，必ず 
sigemptyset 関数や sigfillset 関数によって初期化されている必要がある。 

戻り値一正常に初期化できた場合は0を返し，失敗した場合には一1を返す。 

注 意——通常， sigemptyset 関数はマクロとして定義されるが， __ NO _ SIGNAL _ INLINE __ が 
定義された場合には実体をもつ関数となる。なおマクロ版の sigemptyset 関数は, 
エラー チヱックを行わない ので 注意すること。 

規 格—— POSIX . l ， XPG 3、 AES / OS，SYSV 

関連 r 貝目- sigaction , sigaadset , sigdelset , sigfillset , sigismember , sigpendiner , 

sigprocmask , sigsuspend 
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sigfillset 


用 途——シグナルセットを初期化し，すべてのシグナルを設定する。 

書式- #include く signal . h > 

int sigfillset ( sigset_t * set ); 

解 説一 sigfillset 関数は奶が指す領域に格納されているシグナルセツトを初期化し， 
定義されているすべてのシグナルをシグナルセットに追加する。 sigaddset 関数や 
sigdelset 関数などの操作を行う前には，必ず sigemptyset 関数や sigfillset 
関数によって初期化されている必要がある。 

戻り値——正常に初期化できた場合は〇を返し，失敗した場合には 一1 を返す。 

注 意——通常， sigfillset 関数はマクロとして定義されるが， __ NO _ SIGNAL _ INLINE __ が 
定義された場合には実体をもつ関数となる。なおマクロ版の sigfillset 関数は， 
エラー チヱックを行わない ので 注意すること。 

規 格—— P 0 SIX .1 ， XPG 3, AES / OS、SYSV 

関連項目- sigaction , sigaddset , sigdelset , sigemptyset , sigismember , sigpending , 

sigprocmask ， sigsuspend 
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siqismember 


用 途——シグナルセットに指定したシグナルが設定されているかどうかを調べる。 


書式- #mclude く signal . h > 

mt sigismember 、 sigset_t 本 set,int signo ;; 


解 説- sigismember 関数は如が指す領域に格納されているシグナルセツトに， sign。 で 

指定したシグナルが設定されているかどうかを調べる。 

戻り値——シグナルが設定されていれば0以外の値を返し，設定されていなければ0を返 
す 0 またチェックに失敗した場合は一1を返して，変数 errno にその原因を示す 
エラーコー ドを設定する。 

• EINVAL 不正なシグナル j / gm ? を指定した 


注 意-從 f が指すシグナルセットは，少なくとも1回は sigemptyset 関数あるいは 

sigfillset 関数によって初期化されている必要がある。 

通常， sigismember 関数はマクロとして定義されるが， __ NO _ SIGNAL _ INLINE __ が 
定義された場合には実体をもつ関数となる 0 なおマクロ版の sigismember 関数は， 
エラー チェックを行わないので注意すること。 

規 格一 P0SIX.1，XPG3, AES/OS, SYSV 

関連項目- sigaction , sigaddset , sigdelset , sigemptyset , sigfi 丄 lset ， sigpendmg , 

sigprocmask , sigsuspend 
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siqlonajmp 


用 途——大域ジャンプを実行する。 

書式- # include <setjmp.h> 

void ― volatile siglongjmp (sigjmp_Duf env,int rval); 

解 説- siglongjmp 関数は， sigsetjmp 関数で sigjmp_buf 型の配列に記憶したジャ 

ンプポイントに大域ジャンプを行い，その結果，プログラムカウンタは⑼ v に記 
憶されたジャンプポイントに移る。一方ジャンプポイントでは，記憶を行った 
sigsetjmp 関数が見かけ上の戻り値として， rva / を返すように見える。 

また siglongjmp 関数は，⑼ v が sigsetjmp 関数によってカレントシグナルマス 
クが記憶されている場合に限り，シグナルマスクをから復帰させる。 

siglongjmp 関数は，割り込みルーチンから正常に復帰するために用いる。 

戻り値——なし。この関数は決して戻ってこず，⑼ v で指定したジャンプポイントに実行を 
移す。 

注 意 -一 -sigsetjmp 関数での戻り値 mz / は，通常の場合と siglongjmp 関数された場合と 

を区別しなくてはいけないので，0以外の値でなくてはならない。 rvfl / に〇を設 
定した場合は1とみなされる。 

⑼ v は，あらかじめ sigsetjmp 関数によって環境を格納しておく必要がある。も 
し格納されていなかった場合，その動作は一切保証されない。 

siglongjmp 関数が実行され，ジャンプポイントの位置に戻った場合，レジス 
夕に割り当てられた auto 型変数を除くアクセス可能な すべての オブジェクトは， 
siglongjmp 関数が実行されたときの値をもつ。 

sigsetjmp 関数を実行した関数が return やその他の大域ジャンプなどによって， 
より上位（呼び出し元）の関数に戻ってしまった場合，その後で siglongjmp 関 
数によってジャンプボイントに戻ろうとしても，その動作は保証されない。 

シグナル处理中に発生した別のシグナル处理の最中に siglongjmp 関数を実行 
した場合，すなわち入れ子になったシグナル割り込み处理からの siglongjmp 関 
数の動作は保証されない。 

規 格一 ANSI C ， P 0 SIX .1, XPG 3, AES / OS ， 4.3 BSD ， 5 YSF 

関連項目- longjmp , setjmp , sigaction , sigsetimD 
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signal 


用 途ーシグナルハンドラを設定または登録する。 

書式- #include < signal . h > 

void (.♦signal (int sig , void (* func ) unt ；)) ( int ); 


解 説—— signal 関数は，砌で指定したシグナルに対するシグナルハンドラとして/⑽ごを 

登録する。 

をで t 旨定することができるシグナルとそのデフォルトの処理は，次のとおりであ 
る。なお S は強制終了， C はコアダンプ， N はプロセスの中断を表している。ま 
た， DOS 例外とは Human 68 k が生成する例外，ソフト例外は ZJ 5 C •が生成す 
る例外，ハード例外はハードウヱアが生成する例外を表している。 


SIGABRT 

S 

ソフト例外 

ABORT シグナル 

SIGINT 

S 

DOS 例外 

コントロール C インタラプト 

SIGILL 

C 

ハード例外 

不正な命令を実行した 

SIGFPE 

C 

ハード例外 

0 による除算 

SIGKILL 

S 

ソフト例外 

KILL シグナル 

SIGBUS 

C 

ハード例外 

アドレス エラー 

SIGSEGV 

C 

ハード例外 

バスエラー 

SIGALRM 

S 

ハード例外 

リアルタイムクロック割り込み 

SIGTERM 

S 

ソフト例外 

TERMINATE シグナル 

SIGEMT 

C 

ハード例外 

未定義トラップ 

SIGST0P 

N 

ソフト例外 

STOP シグナル 

SIGUSR1 

S 

ソフト例外 

USR 1 シグナル 

SIGUSR2 

S 

ソフト例外 

USR 2 シグナル 


/ w « c はシグナルハンドラの関数へのボインタでなければならないが，それとは別 
に以下の特殊な値を指定することができる。ただし，いずれの場合にも SIGKILL 
シグナルに対しては，いかなる値も指定することができない。 



• SIG—IGN シグナルを無視するようにする。ただし，ハードウェア例外など 

無視しても，結果的にプログラムが暴走してしまうような場合も 
あるので注意されたい 

• SIGJDFL シグナルハンドラをデフォルトのハンドラに戻す。シグナルはそ 

れぞれにデフォルトのシグナルハンドラをもっており，その処理 
を行わせるようにする。詳細については次ページで述べる。何も 
設定されていない場合，すべてのシグナルはデフォルトにこれが 
指定されている。 

• SIGJD 0 S シグナル機構は， L 7 BC では例外処理を用いて実装されているが， 

そのために Human 68 k の例外処理ベクタがフックされている。 
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これを指定することで，指定したシグナルに対する処理をライブ 
ラリではなく， Human 68 k のオリジナルの処理に戻すことが 
できる。 


シグナルが発生すると，ライブラリはまず発生したシグナルに対してシグナルマ 
スクをかけて，シグナルハンドラ実行中，同じシグナルをブロックし，多重にハ 
ンドラが呼び出されることがないようにする。次に，そのシグナルに対するハン 
ドラが登録されている場合は，シグナルハンドラを起動する。シグナルハンドラ 
の引数は1つで，発生したシグナルの番号が int 型の引数で与えられる。シグナ 
ルハンドラから制御が戻ると，ライブラリはさきほど設定したマスクを解除し， 
ペンディングされていたシグナルを解放する。 

シグナルハンドラは， return 文を実行して割り込み発生ポイントに復帰するか， 
siglongjmp 関数によって別の位置へ大域ジャンプするか， exit 関数， abort 関 
数などの関数を用いてプログラムを終了させるかの選択ができる。しかし，ハー 
ドウヱア例外から発生するシグナルのハンドラについては注意が必要である。仮 
に return 文で元に戻ったとしても，正常に実行を継続できるかどうかは未定義 
である。 

戻り値——正常にハンドラを登録できた場合は前のハンドラへのポインタを返し，失敗した 
場合には SIG _ ERR を返して，変数 errno にその原因を示すエラーコードを設定 
する。 

• EINVAL 不正なを指定したか，または SIGKILL だった 

注 意ーシグナルハンドラはリエントラントでない関数を呼び出してはならない。リエン 
トラントな関数とは，実行状態によらずつねに一定の結果を出すことができる関 
数のことで，たとえば静的領域やヒープ領域にアクセスするなど，外部との接点 
があるような関数はこれに該当しない。もしリエントラントでない関数を呼び出 
した場合，その動作は未定義である。 

ではある程度強引な方法でシグナル機構を実装しているため，ハードウヱ 
ア例外に対して，強制終了以外の選択肢をとることは避けるべきである。最悪の 
場合，リセットする以外に回復する方法がなかったり，副作用でデータの破壊を 
引き起こすことがある。 

規 格 —— Project LIBC Group，ANSI C, POSIX.l, XPG3, AES/OS、 4.3BSD， 

SYSV 

関埋項目- abort , exit , longjmp , sigaction 
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siqpendinq 


用 途——現在ペンデイング状態にあるシグナルのセットを取得する。 

谨式- #include く signal . h > 

mt sigpending ^ sigset_t * set ); 

解 説- sigpending 関数は現在シグナルの配信がブロックされ，ペンディング状態にあ 

るシグナルのシグナルセットを求め，その結果を如が指す領域に格納する。 

戻り値一正常に取得できた場合は0を返し，失敗した場合には 一1 を返す。 

注 意——似が指すシグナルセットは，少なくとも1回は sigemptyset 関数あるいは 

sigfillset 関数によって初期化されている必要がある。 

規格—— POSIX.l, XPG3, AES/OS，SYSV 

関連項目- sigaction , sigaddset , sigdelset , sigemptvset , sigfillset , sigismember , 

sigprocmask , sigsuspend 
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siqprocmask 


用 途——ブロックシグナルセットを取得または変更する。 

播 式一 # include < signal . li > 

int sigprocmask (int how , sigset_t * set , sigset _ t * oset ); 

解 説- sigprocmask 関数は，現在ブロックされているシグナルのセットを取得，再設定 

する。もし打が NULL でなければ，カレントシグナルマスクは/ wvv が示す方法 
でから再設定され，が NULL でなければ，元のブロックシグナルセットが 
oset か It す領域に格納される。 

/ ww には次の値を指定することができる。 


• SIG _ BL 0 CK 

• SIG_UNBLOCK 

• SIG.SETMASK 


新しいカレントシグナルマスクは，現在のシグナルマスク 
と set か It すシグナルマスクを加えたものとなる 
新しいカレントシグナルマスクは，現在のシグナルマスク 
セ、ら set か 1旨すシグナルマスクを除いたものとなる 
新しいカレントシグナルマスクは，打が指すシグナルマス 
クで完全に置き換えられる 


新しいシグナルマスクが計算され，その結果として，ブロックされていたシグナ 
ルが解放されるとそれまでブロックされてシグナルペンディングセツトに保存さ 
れていたシグナルは実際に配信される。 


戻り値——正常に取得/設定できた場合は0を返し，失敗した場合には一1を返して，変数 
errno にその原因を示す エラーコー ドを設定する。 


• EINVAL 不正な how を 指定した 


注 意-從 f が指すシグナルセットは，少なくとも1回は sigemptyset 関数あるいは 

sigfillset 関数によって初期化されている必要がある。 

規格—— POSIX . l , XPG 3, AES / OS , SYSV 

関連項目- kill , raise , sigaction , sigaddset ， sigblock , sigde 丄 set ， sigemptyset , 

sigfillset , sigismember ， signal , sigsuspend 
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siqsetimp 


用 途—大域ジャンプ用のジャンプポイントを設定する。 


書式- #mclude く set ] mp . h > 

int sigsetjmp ^ sigjmp_buf env,int savemask ); 

解 説- sigsetjmp 関数は呼び出された時点（ジャンプポイント）での環境を， sigjmp_buf 

型の配列⑼ v に記憶する。この環境⑼ v を，後で siglongjmp 関数に引数として 
与えてやると，制御をジャンプポイントに移すことができる。 

sigsetjmp 関数は setjmp 関数の機能に加え， savemask が Q でなければプロセ 
スのカレントシグナルマスクを記憶する。 


戻り値-記憶を行った場合 sigsetjmp 関数は0を返すが， siglongjmp 関数によって制御 

が移された場合は， siglongjmp 関数で指定した rval が戻り値となる。この rval 
は必ず0以外の値をとるので，両者は区別することができる。 

注 意—— siglongjmp 関数によって正しく環境を復帰させるためには， sigsetjmp 関数は 

以下に述べる文脈にしか存在してはならない。それ以外の場合の動作は一切保証 
されない。 

• 選択文 （ if ， switch ) か反復文 （ while , for，do while ) の制御式 
• 制御式中で，一方が汎整数定数式である関係演算子など非等号演算子のオペ 
ランド 

• 制御式中の！演算子のオペランド 
• 式中のすべての式。 void 型も可 

規格一 P0SIX.1，XPG3、AES/OS, SYSV 
関埋項目- long jmp , setjmp，siglongjmp 
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sigsuspend 


用 途——シグナルが配信されるのを待つ。 

書式- #include く signal . h > 

int sigsuspend ( sigset_t * sigmask ); 

解 説—— sigsuspend 関数はカレントシグナルマスクを似 A : が指すマスクで置き換え， 

シグナルが配信されるまで（すなわち sigaction 関数や signal 関数で設定した 
シグナルハンドラが実行されるか，プロセス自体が終了するまで)，現在実行中の 
ブロセスを中断する。 

シグナルが配信され，ブロセスの実行が再開すると，カレントシグナルマスクは 
sigsuspend 関数が実行される以前の値に戻される。 

戻り値——正常に取得/設定できた場合は〇を返し，失敗した場合には一1を返す。 

注 意-地 m 似んが指すシグナルマスクは，少なくとも1回は sigemptyset 関数あるいは 

sigfillset 関数によって初期化されている必要がある。 

規 格一 P0SIX.1 , XPG3, AES/OS, SYSV 

関連項目- kill , raise , sigaction , sigaddset , sigblock , sigdelset , sigemptyset , 

sigfillset , sigismember ， signal , sigprocmask 
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用 途-正弦 sin ( x ) を求める。 

書 式- #include < math . h > 

double sin (double x ); 

#include < sys / xmath . h > 
double _ f_sin (double x ); 
double _ fe_sin (double x ); 
double _ fpu_sin (double x ); 

解 説—— sin 関数は； c (単位：ラジアン）の正弦（サイン）を求める。各関数はそれぞれ次の 

ように動作する。 


• sin 数値演算コプロセッサが使用できる場合は数値演算コプロセッサ 

を直接ドライブし，使用できない場合は FLOAT パッケージを呼 
び出す 

• _ f_sin 数値演算コプロセッサ命令を直接ドライブする 

• _ fe_sin FLOAT パッケージを呼び出す 

• _ fpu_sin I/O 数値演算コプロセッサを直接ドライブする 


戻り値——正しく値が求められた場合， sin 関数はズの正弦を返す 0 もしズが非数 （ NaN ) な 
らば変数 errno に EDOM を設定して同じく非数を返し，それ以外のエラーでは， 
変数 errno に ERANGE を設定して計算結果を返す。ただし計算結果は不正確な値 
になる。 


• EDOM ズの値が非数，または士 HUGE-VAL 

• ERANGE JC の値が大きく計算結果の有効桁が一部失われる場合，またはズ 

の値が非つねに大きくて計算結果の有効桁が完全に失われる場合 



注 意——く math . を読み込む前に， „ DIRECT _ FLOAT __ が定義されているときは sin は 

jfe _ sin の別名となり， __ DIRECT _ IOFPU __ が定義されているときは sin は _ fpu_sin 
の別名となる。また， __ DIRECT _ FPU „ が定義されているときは sin は _ f _ sin の別 
名となる。 

数値演算コプロセッサの場合のみ， ERANGE が設定される。 
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規 格 

関連項目 


Project LIBC Group，ANSI C, POSIX.l, XPG3, AES/OS, 4.3BSD, 
SYSV 

asin , isnan 
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用 途-双曲正弦 sin / i (: r ) を求める。 


書 式- #include < math . h > 

double sinh (double x ); 
#include < sys / xmath . h > 
double _ f_sinh (double x ); 
double _ fe_sinh (double x ); 
double _ fpu_sinh (double x ); 


解 説—— sinh 関数はズの双曲正弦（ハイパポリックサイン）を求める。各関数はそれぞれ 
次のように動作する。 

• sinh 数値演算コプロセッサが使用できる場合は数値演算コブロセッ 

サを直接ドライブし，使用できない場合は FLOAT パッケージを 
呼び出す 

• jf_sinh 数値演算コプロセッサ命令を直接ドライブする 

• _ fe_sinh FLOAT パッケージを呼び出す 

• ^ pu_sinh I / O 数値演算コプロセッサを直接ドライブする 


戻り値——正しく値が求められた場合， sinh 関数は; c の双曲正弦を返す 0 もしズが非数 （ NaN ) 
ならば変数 errno に EDOM を設定して同じく非数を返し，それ以外のエラーでは 
変数 errno にその原因となるエラーコードを設定して無限大を返す。 

• EDOM ズの値が非数 

• ERANGE 計算結果が才ーバーフローした 

注 意—— 〈 math . h 〉 を読み込む前に， -_ DIRECT _ FLOAT __ が定義されているときは sinh 

は _f e _ sinh の別名となり， __ DIRECT _ IC ] FPU __ が定義されているときは sinh は 
_ fpu _ sinh の別名となる。また， __ DIRECT _ FPU __ が定義されているときは sinh は 
_f _ sinh の別名となる。 

数値演算コプロセッサの場合のみ， ERANGE が設定される。 

規 格 —— Project LIBC Group, ANSI C, POSIX.l, XPG3, AES/OS, 4.3BSD, 

SYSV 


関連項目-- as in , sin 
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sizmem 


用 途——空きメモリ容量をロングワード単位で調べる。 

書 式- # include < stdlib . h > 

size_t sizmem ( void ); 

解 説—— sizmem 関数は空きメモリ容量，正確には連続して確保できる最大の空きメモリ 

ブロックのサイズを調べ，その結果をロングワード単位で返す。 

戻り値-空きメモリ容量をロングワード （4 バイト）単位で返す。 

注 意一正確には空きメモリ容量とは異なる。また，ここでいう空きメモリブロックとは, 

Human 68 k が管理しているメモリブロックのことであり，ブロセスのヒープ領 
域から確保されるメモリブロック（管理するのはプロセス自身）ではない。 

規 格 —— Project LIBC Group， XC 

関連項目- brk , chkml 
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sleep 


用 途——秒単位のスリープを実行する。 


書 式- #include < unistd . h > 

unsigned int sleep (unsigned int seconds ); 


解 説—— sleep 関数は從⑺バゐで指定した秒数だけ，現在実行中のプロセスをスリープさ 

せる。プロセスは指定した時間スリープするか，シグナルが通知されてシグナル 
ハンドラが呼び出された場合に，スリーブ状態から復帰する。 


戻り値——指定した時間が経過した場合は〇を，途中でシグナルによって中断された場合は 
残りスリープ時間（秒単位）を返す。 


規 格—— P0SIX.1, XPG3, AES/OS, 4.3BSD, SYSV 
関連項目- pause , signal , usleep 
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用 途 -プログラムを実行する。 

書式- #include < unistd . h > 

int spawnl (int mode , const char * path , const char * argO , …）； 

解 説 —— spawnl 関数は現在実行中のプログラムに代わり，/?がみで指定したプログラムを 

mo みの実行モードで起動し，制御を移す。 mo みに指定できる実行モードは次の 
とおりである。 

• P —0 VERLAY execl 関数の実行と同じ。詳細は execl 関数を参照のこと 

• P—WAIT 子プロセスが終了するまで待機する 

spawnl 関数には似ぎ以降に，任意の数の引数列（文字列の集合）を渡すことがで 
き，それらは起動されるプログラムに引数として渡される。 C のプログラムは 
起動時されると main 関数に argc と argv という引数配列が渡されるが， argQ か 
らの一連の引数は，この配列を直接指定しているのと同じである。ただし 
似客 v [0] はプログラム自身を表すので，普通は/と同じ値を設定する。また引 
数列の最後に，終端記号として NULL を指定すること。 

戻り値 ——実行モードが P -0 VERLAY ならば，正常に実行できた場合， spawnl 関数は戻ってこ 
ない。失敗した場合は一1を返して，変数 errno にその原因を示すエラーコード 
を設定する。また実行モードが P-WAIT ならば，正常に実行できた場合， spawnl 
関数は子プロセスの終了コードを返す。失敗した場合は一1を返して，変数 errno 
にその原因を示すエラーコードを設定する。 

• E 2 BIG 引数列が多すぎる 

• EN 0 ENT が / z で指定されたプログラムが見つからない 

• EL 0 QP シンボリックリンクのネストが深すぎるか，またはループしている 

• EN 0 MEM メモリが足りなくなった 

注 意 —— 実行しようとするプログラムが HUPAIR 仕様に準拠したプログラムならば，引 

数は HUPAIR 仕様にしたがってエンコードされ，ブログラムに渡される。逆 
に， HUPAIR 仕様に準拠していないプログラムの場合， Human 68 k で規定さ 
れている通常の方法によって引数が渡される。 

規 格 - Project LIBC Group 、 MS-C7.0 
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用 途——プログラムを実行する。 

書 式- #include < unistd . h > 

int spawnle (int mode , const char * path , const char * argO , 
char * const envp []); 

解 説—— spawnle 関数は現在実行中のプログラムに代わり， path で指定したプログラムを 
mo みの実行モードで起動し，制御を移す。 mo 办に指定できる実行モードは次の 
とおりである。 

• P.OVERLAY execle 関数の実行と同じ。詳細は execle 関数を参照のこと 

• P_WAIT 子プロセスが終了するまで侍機する 


spawnle 関数には以ど以降に，任意の数の引数列（文字列の集合）を渡すことが 
でき，それらは起動されるプログラムに引数として渡される。 C のプログラムは 
起動時されると main 関数に argc と argv という引数配列が渡されるが， argQ か 
らの一連の引数は，この argv 配列を直接指定しているのと同じである。ただし， 
似が[0]はプログラム自身を表すので，普通は/7が / z と同じ値を設定する。また引 
数列の最後に，終端記号として NULL を指定すること。 

spawnle 関数は実行するプログラムに与える環境エリアを，⑼ v /7 の配列で指定 
することができる（⑼ v /7 は引数列の最後に設定される NULL の次である）。実行さ 
れるプログラムが，もし getenv 関数などによって環境変数を検索しようとする 
と，この配列の内容が検索されることになる。この配列の構造については変数 
environ を参照のこと。 

戻り値——実行モードが P -0 VERLAY ならば，正常に実行できた場合， spawnle 関数は戻って 
こない。失敗した場合は一1を返して，変数 errno にその原因を示す エラー コード 
を設定する。また実行モードが P - WAIT ならば，正常に実行できた場合 ， spawnle 
関数は子プロセスの終了コードを返す。失敗した場合は一1を返して，変数 errno 
にその原因を示す エラー コードを設定する。 



• E 2 BIG 引数列が多すぎる 

• ENOENT /7加々で指定されたプログラムが見つからない 

• EL 00 P シンボリックリンクのネストが深すぎるか，またはループしている 

• EN 0 MEM メモリが足りなくなった 
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注 意一実行しようとするプログラムが HUPAIR 仕様に準拠したプログラムならば，引 
数は HUPAIR 仕様にしたがって エンコードされ， ブログラムに渡される。逆 
に， HUPAIR 仕様に準拠していないブログラムの場合， Human 68 k で規定さ 
れている通常の方法によって引数が渡される。 

規 格 —— Project LIBC Group、MS-C7.0 

関連項目 - spawnl ， SDawnlp, spawnv ， spawnve, spawnvp 





Chapterl-C 標準関数ライブラリ 



用 途ープログラムを実行する。 


書 式- 一 -#include < unistd . h > 

int spawnlp (int mode , const char * fiie , const char * argO , •••); 


解 説—— spawnlp 関数は現在実行中のプログラムに代わり，如で指定したプログラムを 

wo みの実行モードで起動し，制御を移す。 wo みに指定できる実行モードは次の 
とおりである。 

• P.OVERLAY exec 関数の実行と同じ。詳細は execlp 関数を参照のこと 

• P.WAIT 子プロセスが終了するまで待機する 


spawnlp 関数には以ざ以降に，任意の数の引数列（文字列の集合）を渡すことが 
でき，それらは起動されるプログラムに引数として渡される。 C のプログラム 
は起動されると main 関数に wgc と argv という引数配列が渡されるが， argOt、 
らの一連の引数は，この orgv 配列を直接指定しているのと同じである。ただし， 
aav [0] はプログラム自身を表すので，普通は处と同じ値を設定する。また引 
数列の最後に，終端記号として NULL を指定すること。 

呼び出されるプログラムは Ji/e で指定する 。もしも file が“/”や“ Y のようなパ 
スの区切り記号を含んでいれば，处はプログラムのパスを示しているとみなさ 
れる。しかし区切り記号が含まれていなければ， spawnlp 関数は如という名前 
のファイルを環境変数 path に設定されているディレクトリ中から検索し，最初 
に見つかったものを実行する。 

戻り値——実行モードが P -0 VERLAY ならば，正常に実行できた場合 spawnlp 関数は戻ってこ 
ない。失敗した場合は一1を返して，変数 errno にその原因を示すエラーコード 
を設定する。また実行モードが P-WAIT ならば，正常に実行できた場合 spawnlp 
関数は子プロセスの終了コードを返す。失敗した場合は一1を返して，変数 errno 
にその原因を示すエラーコードを設定する。 


• E 2 BIG 引数列が多すぎる 

• EN 0 ENT 如で指定されたプログラムが見つからない 

• EL 0 QP シンボリックリンクのネストが深すぎるか，またはループしている 

• EN 0 MEM メモリが足りなくなった 


注 意——実行しようとするプログラムが HUPAIR 仕様に準拠したプログラムならば，引 

数は HUPAIR 仕様にしたがってエンコードされ，プログラムに渡される。逆 
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に， HUPAIR 仕様に準拠していないプログラムの場合， Human 68 k で規定さ 
れている通常の方法によって引数が渡される。 


規 格 —— Project LIBC Group, MS-C 7.0 

関連項目 - spawnl ， spawnle, spawnv, spawnve，spawnvp 
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spawnv 


用 途—ブログラムを実行する。 

書式- #include <unistd.h> 

int spawnv (int mode, const char *path, char *const axgv[]); 

解 説—— spawnv 関数は現在実行中のプログラムに代わり， path で指定したプログラムを 

wo みの実行モードで起動し，制御を移す。办に指定できる実行モードは次の 
とおりである。 

• P_0VERLAY exec 関数の実行と同じ。詳細は execv 関数を参照のこと 

• P_WAIT 子プロセスが終了するまで待機する 

spawnv 関数には argv で， 任意の数の引数列（文字列の集合）を渡すことができ， 
それらは起動されるブログラムに引数として渡される。 C のプログラムは起動さ 
れると main 関数にと argv という引数配列が渡されるが， spawnv 関数で指 
定する argv (i, この main 関数の ar ぎ v 配列を直接指定しているのと同じである。 
ただし argv [01 はプログラム自身を表すので，普通は/^认と同じ値を設定する。 
また引数配列の最後に，終端記号として NULL を指定すること。 

戻り値——実行モードが P-0VERLAY ならば，正常に実行できた場合 spawnv 関数は戻ってこ 
ない。失敗した場合は一 1 を返して，変数 errno にその原因を示す エラー コード 
を設定する。また実行モードが P-WAIT ならば，正常に実行できた場合 spawnv 関 
数は子プロセスの終了コードを返す。失敗した場合は一 1 を返して，変数 erriio 
にその原因を示す エラー コードを設定する。 


• E2BIG 引数列が多すぎる 

• ENOENT path で指定されたプログラムが見つからない 

• ELG0P シンボリックリンクのネストが深すぎるか，またはループしている 

• EN0MEM メモリが足りなくなった 


注 意——実行しようとするプログラムが HUPAIR 仕様に準拠したプログラムならば，引 
数は HUPAIR 仕様にしたがって エンコードされ， プログラムに渡される。逆 
に， HUPAIR 仕様に準拠していないプログラムの場合， Human 68 k で規定さ 
れている通常の方法によって引数が渡される。 

規 格 —— Project LIBC Group 、 MS - C 7.0 


関連項日 - sDawnle, spawn 丄 p ， spawnve, spawnvp 
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spawn ve 


用 途 ——プログラムを実行する。 

書 式 - #include < unistd . h > 

int spawnve (int mode , const char * path , char *const argv [] 
char * const envp []); 

解 説 —— spawnve 関数は現在実行中のプログラムに代わり， path で指定したプログラムを 
wo みの実行モードで起動し，制御を移す。 mo みに指定できる実行モードは次の 
とおりである。 

• P _0 VERLAY exec 関数の実行と同じ。詳細は execve 関数を参照のこと 

• P.WAIT 子プロセスが終了するまで待機する 

spawnve 関数には『以で，任意の数の引数列（文字列の集合）を渡すことができ， 
それらは起動されるプログラムに引数として渡される。 C のプログラムは起動時 
されると main 関数に0/双と0/*がという引数配列が渡されるが， spawnve 関数で 
指定する argvit , この main 関数の配列を直接指定しているのと同じであ 
る。ただし a ; 及 v [0] はプログラム自身を表すので，普通は/?似 / z と同じ値を設定 
する。また引数配列の最後に，終端記号として NULL を指定すること。 

spawnve 関数は実行するプログラムに与える環境エリアを，⑼ v /7 の配列で指定 
することができる（⑼ v /7 は引数列の最後に設定される NULL の次である）。実行さ 
れるプログラムが，もしも getenv 関数などによって環境変数を検索しようとす 
ると，この配列の内容が検索されることになる。この配列の構造については変数 
environ を参照のこと。 

戻り値 ——実行モードが P -0 VERLAY ならば，正常に実行できた場合 spawnve 関数は戻ってこ 
ない。失敗した場合は一1を返して，変数 errno にその原因を示すエラーコード 
を設定する。また実行モードが P - WAIT ならば，正常に実行できた場合 spawnve 
関数は子プロセスの終了コードを返す。失敗した場合は一1を返して，変数 errno 
にその原因を示すエラーコードを設定する。 


• E 2 BIG 引数列が多すぎる 

• ENDENT paM で指定されたプログラムが見つからない 

• EL 00 P シンボリックリンクのネストが深すぎるか，またはループしている 

• EN 0 MEM メモリが足りなくなった 
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注 意一実行しようとするプログラムが HUPAIR 仕様に準拠したプログラムならば，引 

数は HUPAIR 仕様にしたがってエンコードされ，プログラムに渡される。逆 
に， HUPAIR 仕様に準拠していないプログラムの場合， Human 68 k で規定さ 
れている通常の方法によって引数が渡される。 

規 格 - Project LIBC Group , MS-C 7.0 

関埋項目- spawnl , spawnle , spawnlp , spawnv , spawnvp 
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spawnvp 


用 途——プログラムを実行する。 

書 式- #include く皿 istd . h 〉 

int spawnvp (int mode , const char * file , char *const argv 口）； 

解 説一 spawnvp 関数は現在実行中のプログラムに代わり，如で指定したプログラムを 

mo みの実行モードで起動し，制御を移す。 mo みに指定できる実行モードは次の 
とおりである。 

• P .OVERLAY exec 関数の実行と同じ。詳細は execvp 関数を参照のこと 

• P.WAIT 子プロセスが終•了するまで待機する 

spawnvp 関数には argv で，任意の数の引数列（文字列の集合）を渡すことができ， 
それらは起動されるプログラムに引数として渡される。 C のブログラムは起動さ 
れると main 関数に argc h argv という引数配列が渡されるが， spawnvp 関数で 
指定する argvit , この main 関数の orgv 配列を直接指定しているのと同じであ 
る。ただしの客 v [0] はプログラム自身を表すので，普通は如と同じ値を設定す 
る。また引数配列の最後に，終 S 記号として NULL を指定すること。 

呼び出されるプログラムは如で指定する。もしも处が“/”や“\”のようなパ 
スの区切り記号を含んでいれば，ルはプログラムのパスを示しているとみなさ 
れる。しかし区切り記号が含まれていなければ， spawnvp 関数は#たという名前 
のファイルを環境変数 path に設定されているディレクトリ中から検索し，最初 
に見つかったものを実行する。 

戻り値——実行モードが P _0 VERLAY ならば，正常に実行できた場合 spawnvp 関数は戻ってこ 
ない。失敗した場合は一1を返して，変数 errno にその原因を示すエラーコード 
を設定する。また実行モードが P-WAIT ならば，正常に実行できた場合 spawnvp 
関数は子プロセスの終了コードを返す。失敗した場合は一1を返して，変数 eixno 
にその原因を示すエラーコードを設定する。 


• E 2 BIG 引数列が多すぎる 

• EN 0 ENT ガ e で指定されたプログラムが見つからない 

• EL 00 P シンボリックリンクのネストが深すぎるか，またはループしている 

• EN 0 MEM メモリが足りなくなった 
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注 意一実行しようとするプログラムが HUPAIR 仕様に準拠したブログラムならば，引 

数は HUPAIR 仕様にしたがって エンコードされ， プログラムに渡される。逆 
に， HUPAIR 仕様に準拠していないプログラムの場合， Human 68 k で規定さ 
れている通常の方法によって引数が渡される。 

規 格 —— Project LIBC Group，POSIX.l, XPG3, AES/OS, 4.3BSD, SYSV 

関埋項目- spawnl , spawnle ， spawnlp , spawnv , spawnve 
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sprintf 


用 途 ——文字列に対してフォーマット出力を行う。 

書 式 - #include <stdio . h > 

int sprintf (.char * s , const char * format , 

解 説 —— sprintf 閨数は format で指定したフォーマット文字列にしたがって引数を文字 

列に変換し，その結果を^が指す領域に格納する。フォーマット文字列の指定方 
法や詳細な説明については， fprintf 関数を参照のこと。 

戻り値 ——正常に出力できた場合は出力した文字数を返し，失敗した場合は EOF を返す。 

注 意 ——は結果を格納するだけの十分な大きさの領域を指していなければならない。ま 
た，一度に出力できる文字列のサイズは 32 K バイトに限定される。その他の制限 
事項は， fprintf 関数を参照のこと 0 

規 格 —— ANSI C ， POSIX . l , XPG 3, AES / OS ， 4.3 BSD，SYSV 

関連項目- eprintf , fprintf , printf 
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用 途-平方根%/^を求める。 

書 式- #include < math . h > 

double sqrt (doub 丄 e x ); 

#include < sys / xmath . h > 
double _ f_sqrt (double x ); 
double _ fe_sqrt (double x ); 
double _ fpu_sqrt (double x ); 

解 説—— sqrt 関数は； c の負でない平方根（ルート）を求める。各関数はそれぞれ次のよう 

に動作する。 

• sqrt 数値演算コプロセッサが使用できる場合は数値演算コプロセッサ 

を直接ドライブし，使用できない場合は FLO AT パッケージを呼 
び出す 

• _ f_sqrt 数値演算コブロセッサ命令を直接ドライブする 

• _ fe_sqrt FLOAT パッケージを呼び出す 

• _ fpu_sqrt 1/0数値演算コプロセッサを直接ドライブする 

戻り値——正しく値が求められた場合， sqrt 関数は； C の平方根を返す 0 X が非数 （ NaN ) また 
は負の値だった場合は，変数 errno に EDOM を設定して同じく非数を返す。 

• EDOM JC の値が非数，またはズの値が負の値 


注 意—— Cmath . h 〉 を読み込む前に ， -DIRECT JFL 0 AT — が定義されているときは sqrt 
は- fe _ sqrt の別名となり， __ DIRECT _ IOFPU __ が定義されているときは sqrt は 
_ fpu _ sqrt の別名となる。また， __ DIRECT _ FPU „# 定義されているときは sqrt は 
- f - sqrt の別名となる。 



規 格 —— Project LIBC Group , ANSI C , POSIX . l , XPG 3、 AES / OS ， 4.3 BSD ， 

SYSV 


関連項目- isnan 
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srand 


用 途——乱数シードを初期化する。 

書 式- # include < stdlib . h > 

void srand (unsigned int seed ); 

解 説- srand 関数は， rand 関数や random 関数で用いられる乱数発生ルーチンで使用さ 

れる乱数シードを货どゴに設定し，乱数系列を初期化する。 rand 関数などで得ら 
れる乱数列の各要素自体は乱数であり，お互いに相関関係をもたない（実用的範 
囲で）が，乱数列全体としては乱数シードに対して一定である。 

戻り値——なし。 

注 意—— srand 関数と srandom 関数とは，関数インタフェイスが異なる以外は実質的に同 

じものであり，たとえば srand 関数は rand 関数とともに random 関数にも影響 
をおよぼす。 

規 格 —— ANSI C , POSIXA ， XPG 3, AES / OS ，4.3 BSD , SYSV 

関埋項目- rand ， random , srandom 
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srandom 


用 途一乱数シードを初期化する。 


書 式- #include く stdlib . h 〉 

unsigned int srandom (unsigned int seed ); 


解 説- srandom 関数は， rand 関数や random 関数で用いられる乱数発生ルーチンで使用 

される乱数シードを此れ/に設定し，乱数系列を初期化する。 rand 関数などで得 
られる乱数列の各要素自体は乱数であり，お互いに相関関係をもたない（実用的 
範囲で）が，乱数列全体としては乱数シードに対して一定である。 

戻り値一変更する前の乱数シードを返す。 


注 意 - sr and 関数と srandom 関数とは，関数インタフェイスが異なる以外は実質的に同 

じものであり，たとえば srandom 関数は random 関数とともに rand 関数にも影 
響をおよぼす。 

規 格 —— Project LIBC Group ，4.3 BSD 

閨連項目- rand , random , srand 
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sscanT 


用 途一文字列からフォーマット入力を実行する。 

書 式- # include <stdio . h > 

mt sscanf (const char * s , const char * format , ... ノ； 

解 説—— sscanf 関数は， / brm 如で指定した入カフォーマツト文字列にしたがって必要な 

データ列を J で指定した文字列から入力し，その結果を引数の指す領域に格納す 
る。入カフォーマット文字列の指定方法や詳細な説明については， fscanf 関数を 
参照のこと。 

戻り値——正常に入力できた場合は実際に入力できた項目数を返し，失敗した場合は EOF を 
返す。 

注 意——引数に指定するボインタは，結果を格納するための十分な大きさの領域を指して 

いなければならない。 

規 格 —— ANSI C , POSIX . l , XPG 3 y AES / OS ，4.3 BSD , SYSV 

関連項目- fscanf，scanf 
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stat 


用 途ーファイルのステータス 情報を取得す る。 


書 式- #include <stat . h > 

int stat (const char * name , struct stat * st ); 

int fstat (int fno , struct stat * st ); 

int 1 stat (const char * name , struct stat * st ); 


解 説一 stat 関数と lstat 関数は，の指すファイルのステータス情報を取得し，そ 

の結果をがポインタで指される構造体に代入する。また fstat 関数は，/加で指 
定したファイルハンドルが指すファイルのステータスを取得し，その結果を以ポ 
インタで指される構造体に代入する。 

シンボリツクリンクはファイルのステータスを取得する前に解決されるが， lstat 
関数を用いれば，シンボリックリンクを解決せずにリンクファイル自体の情報を 
取得することができる。 

stat 構造体の構造は次のとおり 0 まず，対象が通常のファイルまたはデイレクト 


リである場合。 



struct stat 

{ 



dev_t 

st_dev; 

/* 

物理ドライブ番号 */ 

ino_t 

st_ino; 

/* 

物理ドライブ X16777216 + 先頭セクタ番号 */ 

mode_t 

st_mode; 

/* 

ファイルモード */ 

nlink_t 

st.nlink; 

/* 

つねに 1 */ 

uid_t 

st_uid; 

/* 

つねに 0 (root) */ 

gid_t 

st.gid; 

/* 

つねに O(root) */ 

dev_t 

st_rdev; 

/* 

論理ドライブ番号 */ 

off _t 

st.size; 

/* 

ファイルサイズ，デイレクトリサイズ */ 

time_t 

st_atime; 

/* 

最終ァクセス時間 */ 

time_t 

st_mtime; 

/* 

最終変更時間 */ 

time_t 

st_ctime; 

/* 

最終作成時間 */ 


>； 



• st_ino は物理ドライブ番号を24ビットシフトし，対象となるファイルの先 
頭セクタ番号を加えた値を返す 

• st_mode は拡張 UNIX ファイルモードの値を返す 

• st_size はターゲットがファイルの場合はファイルサイズを返し，ディレク 
トリの場合はディレクトリエントリのサイズを返す 
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次に対象がキャラクタ型デバイスである場合。 


struct stat 

■c 




dev_t 

st.dev; 

/* 

デバイスドライバの 常駐 アドレス 

*/ 

ino_t 

st_ino; 

/* 

つねに0 */ 


mode_t 

st_mode; 

/* 

つねに S.IFCHR | S.IWRITE | 

S.IREAD */ 

nlink_t 

st_nlink; 

/* 

つねに1 */ 


uid_t 

st_uid; 

/* 

つねに0 (root) */ 


gid.t 

st.gid; 

/* 

つねに0 (root) */ 


dev_t 

st_rdev; 

/* 

デバイスドライバの 常駐 アドレス 

*/ 

off_t 

st_size; 

/* 

つねに0 */ 


time_t 

st_atime; 

/* 

つねに 0(1970 年1月1日）*/ 


time_t 

st_mtime; 

/* 

つねに 0(1970 年1月1日）*/ 


time.t 

st_ctime; 

/* 

つねに 0(1970 年1月1日）*/ 



>; 


•標準入出力および標準エラー出力， AUX , PRN にリンクされているキャラク 
夕型デバイスドライバにかぎり，情報を得ることができる。また，シンポ 
リックリンクのリンク先がキャラクタ型デバイスの場合も可能 

• st _ dev および st _ rdev はデバイスドライパが常駐している先頭アドレスを 
返す 

• stiode は拡張 UNIX ファイルモードの値を返す 


拡張 UNIX ファイルモードの値は次のように定義されている。まず，ファイル 
モードの下位16ビットは，一般に UNIX で定義されているファイルモードと 
ビットレべルで完全に互換であるようになっている。 


S.IX0TH 

00000001 

第3者実行 

S—IW0TH 

00000002 

第3者書き込み 

S-IR0TH 

00000004 

第3者読み込み 

S—IXGRP 

00000010 

グループ実行 

S-IWGRP 

00000020 

グループ 書き込み 

S-IRGRP 

00000040 

グループ読み込み 

S—IXUSR 

00000100 

オーナー実行 

S—IWUSR 

00000200 

オーナー書き込み 

S-IRUSR 

00000400 

オーナー読み込み 

S-ISVTX 

00001000 

スティッキービット（つねに 0) 

S_ISGID 

00002000 

Set GID ビット（つねに 0) 

S.ISUID 

00004000 

Set UID ビット（つねに 0) 


下位16ビット内でも，次の値はビット値の論理和で設定されているわけではな 
いので，注意が必要である。これらの値をチヱックするには，ファイルモードに 
対して S_IFMT でマスクをかけてから等号で行う。決して，論理積でチェックして 
はいけない。またこれらの目的のために， S-ISCHR や S-ISDIR などのマクロがあ 
る 0 詳細はく sys / stat 上〉を参照のこと 0 
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S.IFIF0 

00010000 

FIFO (つねに 0) 

S_IFCHR 

00020000 

キャラクタデバイス 

S_IFDIR 

00040000 

ディレクトリ 

S.IFBLK 

00060000 

ブロックデバイス 

S.IFREG 

00100000 

通常ファイル 

S.IFLNK 

00120000 

シンボリックリンク 

S-IFSOCK 

00140000 

ソケット（つねに 0) 


次に上位16ビットだが，こちらは Human 68 k の特殊な属性情報を管理するた 
めに桩張されている。通常 UNIX のファイルモードは16ビットなので，この部 
分がアクセスされることはない。 


S-IRD0NLY 

00200000 

リードオンリー 

S.IFV0L 

00400000 

ポリュームファイル 

S.ISYS 

01000000 

システムファイル 

S.IHIDDEN 

02000000 

隠しファイル 

S_IEXBIT 

04000000 

実行ビット 


• 実行属性/書き込み属性はオーナー/グループ/第3者すベて同じ値が設定さ 
れる 

• 読み込み属性はつねに有効になる 


戻り値——正常に情報を取得できた場合は〇を返し，失敗した場合には 一1 を返して，変数 
errno にその原因を示す エラーコー ドを設定する 0 

• EN 0 ENT フアイルが見つからない 


注 意—— st _ dev の値は，仮想ドライブ，仮想ディレクトリ，シンボリックリンクを展開し 

た値が設定されるが，シンボリックリンクファイルのネストは1段までしか参照 
しないため，完全には物理ドライブにならない場合もありえる。また， st _ ino も 
同じである。 

規 格 —— Project LIBC Group ， POSIX . l , XPG 3, AES / OS ，4.3 BSD , SYSV 

関連項目- _ mode 2 dos , _ mode 2 unix , chmod , fchmod , open ， symlink , utime 
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strcat 


用 途——文字列をほかの文字列に連結する。 

書 式 - - #include く string . h > 

char *strcat (char * stringl , const char * string 2); 

解 説—— strcat 関数は打/*/ > zg 2 の指す文字列を，於/の指す文字列の最後にコピーし， 

連結した文字列の最後に null 文字を追加する。 stringl の末昆の null 文字には， 
打/7>?がの最初の文字を重ねてコピーする。 

戻り値-打；7>2ぎ/へのポインタを返す。 

注 意—— stringl は ，連結した結果の文字列を格納するのに十分な領域を指していなければ 
ならない。1文字は1バイトを意味する。 

規 格—— ANSI C , P 0 SIX .1, XPG 3、 AES / OS , 4.3 BSD，SYSV 

関連項目- st meat 
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strchr 


用 途——文字列中から指定文字を検索する。 

谨工く - #inc 丄 ude <stnng.h> 

char *strchr (const char * strinff , int character ); 

解 説—— strchr 関数は於/*/叩が指す文字列中から， c / zflrac 於/■で指定された文字を検索す 

る 0 打/7>2ど末尾の null 文字も検索の対象となり得る。 character は， 内部で int 
型から char 型に変換される。 

戻り値一 打/ */叹 中で最初に現れた character へのポインタを返し，見つからない場合は 
NULL を返す。 

注 意 -1文字は1バイトを意味する。 

規 格 —— ANSI C , POSIX . l , XPG 3, AES / OS ，4.3 BSD，SYSV 
関連項目- memchr , strcspn , strpbrk , strrchr , strspn , strstr , strtok 
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strcmo 


用 途一2つの文字列を比較する。 

書 瓦- # include < stnng . h > 

int strcmp (const char * stringl , const char * string 2); 

解 説—— strcmp 関数は打/7せノの指す文字列と打 r /« がの指す文字列を比較する。比較は 

null 文字が検出された時点で終了する。 

戻り値——比較の結果，2つの文字列がまったく同じならば〇を返す。異なる場合，その位 
置での打/側の文字が打/7>^2側の文字よりも大きければ正の値を，小さけれ 
ば負の値を返す。 

注 意——1文字は1バイトを意味する。 

規 格一 ANSI C , P 0 SIX .1， XPG 3, AES / OS ’ 4.3 BSD，SYSV 

関連項目- memcmp ， strcoll , strncmp , strxfrm 
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strcmpi 


用 途——2つの文字列を大文字と小文字を区別しないで比較する。 

it - #mclude く string .h> 

int strcmpi ^const char * stringl,const char * string 2); 

解 説- strcmpi 関数は打//の指す文字列と价/«ぎ2の指す文字列を，大文字/小文字 

を区別しないで比較する。比較は null 文字が検出された時点で終了する。 

戻り値一比較の結果，2つの文字列がまったく同じならば〇を返す。異なる場合，その位 
置での打/客/側の文字が打 n >2 ぎ2側の文字よりも大きければ正の値を，小さけれ 
ば負の値を返す。 

注 意—— strcmpi 関数は文字列を小文字にしてから比較する。 strcmpi 関数はマクロ定義 

であり，実体は stricmp 関数である。1文字は1バイトを意味する。 

規 格 —— Project LIBC Group , 4.3 BSD 

関埋 1 貝目 - memcmp, strcmp, strcoll, stricmD ， strncmp，strxfrm 
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strcoll 


用 途——2つの文字列をロケールを用いて比較する。 

僅 式- # include < string . h > 

int strcoll (const char * stringl,const char * string 2); 

解 説- strcoll 関数は灯/*/の指す文字列と打/7>2^2の指す文字列を，現在のロケー 

ルの LC - COLLATE カテゴリを基に比較する。比較は null 文字が検出された時点で 
終了する。 

戻り値——比較の結果，2つの文字列がまったく同じならば0を返す。異なる場合，その位 
置での打/7>2ざパ則の文字が於側の文字よりも大きければ正の値を，小さけれ 
ば負の値を返す。 

注 意 strcoll 関数は C ロケールにしか対応していないため， strcmp 関数と同じであ 
る。1文字は1バイトを意味する。 

規 格一 Project LIBC Group , ANSI C , XPG 3, AES / OS , SYSV 

関連項目- strlwr ， strupr , strxfrm 
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strcpy 


用 途 一文字列をコピーする。 

書式 - #include く string .h> 

char *strcDV (char *stringl, const char *stnng2；; 

解 説 - strcpy 関数は打/の指す文字列を， null 文字を含めて string 1 の指す領域にコ 

ピーする。 

戻り値—— stHngl へのポインタを返す。 

注 意一領域が重なっていた場合の動作は未定義である。またががは，於/7>2ジの指す 

文字列を格納す るのに 十分な領域を指していなければならない。1文字は1 バイ 
卜を意味す る。 

規格 —— ANSI C ， P 0 SIX .1， XPG 3, AES / OS，SYSV 
関埋ェ貝目 - memcDV ， memset，strncpy 
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strcspn 


用 途——指定文字列に含まれない文字が，ほかの文字列の先頭から何文字続いているかを 

調べる。 

書 式- #include < string . h > 

size_t strcspn (const char * stringl,const char * strmg 2); 

解 説—— strcspn 関数は stringl の指す文字列と价/叹2の指す文字列を比較し， string 1の 
先頭から string 2 に含まれなレ、文字で構成されている部分の長さを調べる。 

戻り値-か//7ぎ7の先頭からび//^ 2に含まれない文字で構成されている部分の長さを返す。 

注 意-1文字は1バイトを意味する。 

規 格—— ANSI C , P 0 SIX .1， XPG 3、 AES / OS ， SYSV 

関連項目- memchr , strchr , strpbrk , strrchr , strspn , strstr , strtok 
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strdup 


用 途——新しい領域を確保して文字列をコピーする。 

書式- #include < string . h > 

char *strdup (const char * string ); 


解 説一 strdup 関数は打の指す文字列を， null 文字を含めて malloc 関数によって確 

保した領域にコピーする。 

戻り値——正常にコピーできた場合はコピー先へのポインタを返し，失敗した場合は NULL 
を返して，変数 erxno にその原因を示すエラーコードを設定する。 

• EN 0 MEM メモリが足りなくなった 


注 意-1文字は1バイトを意味する。 


規 格 —— SYSV 

関連項目- malloc , strcpy 
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strerror 


用 途—— エラー メ ッセージへの ボイ ン タを返す。 

書 式'- # include く string . h > 

char 本 strerror vmt error ;; 

解 説—— strerror 関数は，で示されるエラーコードに対応するエラーメッセージへ 

のボインタを返す。 

戻り値——エラーメッセージへのポインタを返す。失敗した場合は，変数 errno にその原因 
を示す エラー コードを設定して NULL を返す。 

• EINVAL error の値が無効である 

規 格 一 ANSI C , XPG 3, AES / OS，SYSV 

関埋項目- memcpy , memset , strncpy 
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strftime 


用 途—詳細時間の情報を文字列に変換する。 


書 式- #include <time . h > 

size_t strftime (char * s , size_t maxsize , 

const char * format , const struct tm * timeptr ); 

解 説- strftime 関数は印ヶで与えられる詳細時間の情報を， /orw がで指定した 

フォーマットで文字列に変換し，その結果を J の指す領域に格納する。 S の指す領 
域のサイズは mflucsize で制限され，変換結果がこのサイズをこえるようならば, 
maxsize バイ}' に収まる範囲までしか変換が行われない。 

/ bmiar に指定するフォーマット文字は通常の文字列であるが，“7•”で表される変 
換指定文字に続くアルファベット1文字があると，その指示にしたがって変換が 
行われる。これらの変換は，現在のロケールの LC-TIME カテゴリに左右される。 

変換指示文字には次のものが使用できる。 


• # /.a ロケールで定義される曜日名の省略形 

• °/oA ロケールで定義される曜日名 

• °/ 0 b ロケールで定義される月の名前の省略形 

• °/ 0 B ロケールで定義される月の名前 

• 7 ,c ロケールで定義される日付/時間の表現 

• # / 0 d 日の数字表現 (01 < x < 31) 

• %D 日付 ( 0 / 0 m / 0 /. d /°/. y ) 

• °/oh ロケールで定義される月の名前の省略形 

• # /oH 時の数字表現 （24 時間制00ざ x £ 23) 

• °/〇1 時の数字表現 （12 時間制00ざ x ざ 12) 

• °/，3 通算日の数字表現(001 < x < 366) 

• %m 月の数字表現 (01 < x < 12) 

• 分の数字表現 (00 < x < 59) 

• %n 改行文字 

• °/,p ロケールで定義される“ AM ”，“ PM ” 相当の文字列 

• °/.r I 2 時間制の時間表現（英米国式） UlZ/oMAS [ AMIPM ]) 

• °/.S 秒の数字表現(〇〇 < a : < 61) 

• 8 /.t タブ文字 

• # /,T 時間表現 （％ H : % M : % S ) 

• 7 .U 日曜を週の始めとした通算週 (00 < x < 53) 

• 7 oW 曜日の数字表現（日曜が0 0 く : c < 6) 

• °/.W 月曜を週の始めとした通算週 (00 < x < 53) 
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• °/.x ロケールで定義される日付表現 

• %X ロケールで定義される時間表現 

• °/,y 世紀を省いた年の数字表現 （00 < x < 99) 

• 7〇¥ 世紀を伴つた年の数字表現 （ ex . 1993) 

• # /oZ 地域時間の時間帯名称 

• U %文字 

戻り値一正常に変換できた場合は *5 に格納したバイト数（終端の null 文字は含まない）を 
返し，失敗した場合には0を返す。 

注 意——は結果を格納するための十分な大きさの領域を指していることが望ましい。 
互換性——1/忍(7は C ロケールしかサポートしていない。 

規格 —— ANSI C , POS 1 X .1 、 XPG 3、 AES/OS ， SYSV 
関連項目- ctime , tzset 
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stricmp 


用 途一 2つの文字列を大文字と小文字を区別しないで比較する。 

書式- #include < string . h > 

int stricmp (const char * stnngl,const char * stnng 2); 

解 説一 stricmp 関数は打/ 7>? W の指す文字列とが/*/呢2の指す文字列を大文字と小文字を 

区別しないで比較する。比較は null 文字が検出された時点で終了する。 

戻り値——比較の結果，2つの文字列がまったく同じならば0を返す。異なる場合，その位 
置での打; 7>2 g / 側の文字が打/7>2客2側の文字よりも大きければ正の値を，小さけれ 
ば負の値を返す。 

注 意—— stricmp 関数は文字列を小文字にしてから比較する。1文字は1バイトを意味 
する。 

規 格—— Project LIBC Group, 4.3BSD 

関埋項目- memcmp , strcmp , strcmDi , strcoll ， strncmp , strxfrm 



329 






ライブラリー第 2 部 


strien 


用 途—文字列の長さを調べる。 

書 式- # include く string . h > 

size_t strien (const char * string ); 

解 説—— strien 閨数は，於/ 7>2 g の指す文字列の末尾の null 文字を除いた文字列の長さを調 

ベる。 

戻り値一末尾の null 文字を除いた文字列の長さを返す。 

注 意一1文字は1バイトを意味する。 

規 格 —— ANSI C ， POSIX . l , XPG 3, AES / OS , 4.3 BSD , SYSV 
関連項目- strcpy 







Chapter 1— C 標準関数ライブラリ 



用 途——文字列を小文字に変換する。 

書式- #include く string 上〉 

char *strlwr ^chax * string ) ; 

解 説—— strlwr 関数は打/7せが指す文字列を先頭から調べ，現在のロケールの LC-CTYPE 

カテゴリをもとに大文字を小文字に変換する。処理は null 文字を検出した時点で 
終了する。 

戻り値——打/へのポインタを返す。 

注 意一は C ロケールしかサポートしていない。1文字は1バイトを意味する。 

規 格 —— Project LIBC Group , MS - C 7.0 
関連項目- strnset , strrev , strset , strupr 
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strncat 


用 途——文字列を指定文字数だけほかの文字列につけ加える。 


書 式-# include <string.h> 

char *strncat (char *stringl,const char *string2, size 一 t n); 

解 説一 strncat 関数は， 价 /« ぎ 2 の指す文字列を string 1 の指す文字列の最後に コ ピーし, 

連結した文字列の最後に null 文字を追加する。灯/の末尾の null 文字には， 
打 /7>7 が の最初の文字を重ねてコピーする。 コピーは null 文字が検出されるか，/ 2 
文字コピーした時点で終了する。 

戻り値——於/へのポインタを返す。 


注 意一 stringl は ，連結した結果の文字列を格納するのに十分な領域を指していなければ 
ならない。1文字は1バイトを意味する。 


規 格 —— ANSI C , P 0 S 1 X .1 、 XPG 3、 AES / OS , 4.3 BSD 、 SYSV 


関連項目 - strcat 
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strncmp 


用 途——2つの文字列を指定文字数だけ比較する。 

書式- #include く string 上〉 

int strncmp 〈const char * stringi,const char * string 2, size_t n ;; 

解 説一 strncmp 関数は， stringl の指す文字列と於/*/«ぎ2の指す文字列を比較する。比較 

は null 文字が検出されるか，/2文字比較した時点で終了する。 

戻り値——比較の結果，2つの文字列がまったく同じならば0を返す。異なっていたり《文 
字を比較し終えた場合，その位置での打/側の文字が打/*/叹2側の文字よりも 
大きければ正の値を，小さければ負の値を返す。 

注 意-1文字は1バイトを意味する。 

規 格一 ANSI C 、 P 0 SIX .1， XPG 3, AES / OS ， 4.3 BSD，SYSV 

関連項目*— memcmp , strcmp , strcoll，strxfrm 
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strncpy 


用 途——文字列を指定文字数だけコピーする。 

僅 瓦- # include < strmg . h > 

char *strncDV Cchar * stringl , const char * string 2, size.t n ); 

解 説—— strncpy 関数はがの指す文字列の最初の 《 文字までを， stringl の指す領域 
に コピーす る。 コピーは null 文字が検出されるか， 《 文字 コピーした 時点で終了 
する。 

戻り値- 於 /7>1 ぎ 7 へのポインタを返す。 

注 意——領域が重なっていた場合の動作は未定義である。また 打 ^7>2 ぎ 7 は， 《 文字を格納す 

るのに十分な領域を指していなければならない。1文字は1バイトを意味する。 

規 格—— ANSI C 、 POSIX . l , XPG 3, AES / OS ，4.3 BSD，SYSV 

関埋項目- memcpy , memset , strcpy 
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strnset 


用 途 ——文字列を指定文字で指定文字数分だけ埋める。 

僅 式 - #include < string . h > 

char *strnset (char ^ string , int character , size_t n ); 

解 説 - strnset 関数は，对/かぎが指す文字列の先頭から 《 文字か null 文字を検出するま 

で， c/zarac 切/*で指定された文字で埋める。 character •は， 内部で int 型から char 
型に変換される。 

戻り値 -か//^へのポインタを返す。 

注 意—— /2 は文字列領域の大きさを越えてはならない。 1 文字は 1 バイトを意味する。 

規 格一 MS - C7.0 

関連項目 - memset , strlen , strlwr , strrev , strset , strupr 
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strporK 


用 途——指定文字列に含まれる文字がほかの文字列に存在するかどうかを調べる。 

書式-# include < string . h > 

char *strpbrk Cconst char * stringl , const char * string 2；; 

解 説—— strpbrk 関数は stringl の指す文字列と打/7せ2の指す文字列を比較し， string 2 に 
含まれる文字が最初に現れる場所を検索する。 

戻り値- stringl 中で stringl に含まれる文字が最初に現れる位置へのポインタを返し，見 

つからない場合は NULL を返す。 

注 意一1文字は1バイトを意味する。 

規格—— ANSI C , P 0 SIX .1, XPG 3, AES / OS ， SYSV 

関埋 I 貝目 - memchr , strchr , strcspn , strrchr , strspn , strstr , strtok 
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strrchr 


用 途一文字列中から指定文字が最後に現れる位置を検索する。 

兽式- #include く string . h > 

char *strrchr ^const char * string , mt character ;; 

解 説—— strrchr 関数は打/が指す文字列中から，で指定された文字が最後に 
現れる位置を検索する。打/*/叹末尾の null 文字も検索の対象となり得る 。 character 
は，内部で int 型から char 型に変換される。 

戻り値——价/叹中で最後に現れる c / zamc 妙へのポインタを返す。見つからない場合は NULL 
を返す。 

注 意——1文字は1バイトを意味する。 

規格 —— ANSI C , P 0 S 1 X .1、 XPG 3, AES / OS , SYSV 

関連項目—— memchr ， strchr , strcspn , strpbrk , strspn , strstr , strtok 
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strrev 


用 途——文字列を前後反転させる。 

書 式- #include < string . h > 

char *strrev uhar ^ string ); 

解 説- strrev 関数は打/ぎが指す文字列を前後反転させる。 

戻り値- string への ポインタを返す。 

注 意一1文字は1バイトを意味する。 

規 格—— MS - C 7.0 

関連項目- strlwr , strnset , strset , strupr 
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strset 


用 途一文字列を指定文字で埋める。 

書 式- #include く string . h > 

char *strset (char ^ string , int character ;; 

解 説—— strset 関数はが指す文字列の先頭から， null 文字に出会うまで character 

で指定された文字で埋める 0 character は， 内部で int 型から chai •型に変換さ 
れる。 

戻り値- 切 7>2 g へのポインタを返す。 

注 意——1文字は1バイトを意味する。 

規 格—— MS - C 7.0 

関連項目- strlwr ， strnset , strrev , strupr 
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strsianal 


用 途ーシグナルを表す文字列を取得する。 

書 式"-# include く signal.h> 

char *strsignal (int signo); 

解 説—— strsignal 関数は，沿 g ⑽で指定されたシグナルを表す文字列へのボインタを返 
す。たとえば，に SIGABRT を指定すると，以下のような文字列へのポイン 
夕が返る。 

“SIGABRT Abnormal termination” 

戻り値——正常に取得できた場合は文字列へのポインタを返し，失敗した場合は NULL を返 
して，変数 errno にその原因を示すエラーコードを設定する。 

• EINVAL 不正なシグナル signo を 指定した 

規 格- Project LIBC Group , 4.3 BSD 

関連項目- signal, strerror 
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strspn 


用 途——指定文字列に含まれる文字が，ほかの文字列の先頭から何文字続いているかを調 

ベる0 

書式- #include く string . h > 

size_t strspn (const char * stringl , const char * string 2); 

解 説—— strspn 関数は切の指す文字列とが/7せ2の指す文字列を比較し， string 1の 
先頭から string 2 に含まれる文字で構成されている部分の長さを調べる。 

戻り値——於 A 7>2 ぎ/の先頭から打/7>2ぎ2に含まれる文字で構成されている部分の長さを返す。 

注 意——1文字は1バイトを意味する。 

規格 —— ANSI C , POSIX . l , XPG 3, AES/OS ， SYSV 

関連項目- memchr , strchr , strcspn ， strcbrk , strrchr , strstr , strtok 
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strstr 


用 途——指定文字列がほかの文字列に存在するかどうかを調べる。 

書 式 '- #include <string.h> 

size_t strstr ^const char *stringl,const char *string2); 

解 説 - strstr 関数は string 1 の指す文字列と 灯 /7>^2 の指す文字列を比較し， stringl 4 1 

で最初に文字列 stringl が現れる位置を検索する。 

戻り値- string 〗 中で ，最初に string 2 が現れる位置へのポインタを返す。 

注 意-1文字は1バイトを意味する。 

規格 —— ANSI C , POSIX . l ， XPG 3, AES / OS，SYSV 

関連項目 - memchr, strchr, strcspn, strpbrk, strrctir, strspn, strtok 
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strtod 


用 途——文字列を double 型倍精度浮動小数に変換する。 

書 式- #include < stdlib . h > 

double strtod (const char * nptr , char ** endptr ); 

解 説—— strtod 関数は/ 1/7 ヶで指定された文字列を，まず3つの部分文字列，すなわち先 

頭の空白部分，浮動小数部分，認識不能部分（終端の null 文字を含む）に分割す 
る。 strtod 関数はこれらの部分文字列のうち，浮動小数部分の文字列を double 
型倍精度浮動小数に変換し，その値を返す。この浮動小数部分は符号（省略可能)， 
浮動小数および指数（省略可能）からなり，指数部分は“ e ” か“ E ” に続いて符号 
(省略可能）と指数値からなる。 

-3.1415926, 1.8794 E +15, 2.42 e -6 

もし endptr が mJLL でない場合は，⑼办 / r に最後の認識不能部分へのボインタを 
格納する。この部分は終端の null 文字を含むので，1文字以上である。小数点と 
して認識する文字はロケールの LC _ NUMERIC カテゴリに影響される。 

戻り値——変換した結果を返す。ただし結果がオーバーフローした場合は HUGE-VAL を返し， 
アンダーフローした場合は0を返して，変数 errno にその原因を示す エラーコー 
ドを設定する。 

即びが空文字であったり，すべて空白だったり，認識不能文字だったりして浮動 
小数部分の文字列が見つからない場合変換は行われず，〇を返す。また，このと 
き endptr [Ziti / 2 / 7 / r の値が格納される。 

• ERANGE オーバーフロー， あるいはアンダー フローを 起こした 

注 意——は C ロケールしかサポートしていない。 

規格 —— Project LIBC Group , ANSI C , XPG 3, AES / OS , SYSV 
関連項目- atof , atoi , atol , strtol , strtoul 


343 






ライブラリー第 2 部 


strtok 


用 途——文字列を指定した区切文字でトークンに分ける。 

書 瓦- #include < strmg . h > 

char *strtok ^char * string , const char * delim ); 

解 説一 strtok 関数を連続して呼ぶことにより，が指す文字列を語句（卜ークン）に 

分解することができる。各語句は，み/ / m が指す文字列に含まれる区切り文字（デ 
リミタ）によって区切られる。 

最初に strtok 関数を呼び出すときは，デリミタ文字列を打/かぎに指定し，以降 
strtok 関数を呼び出すときには，に NULL を指定する。デリミタ文字は， 
strtok 関数を呼び出すたびに変えることが可能である。 string にデリ ミタ文字が 
続く場合は無視される。 

戻り値——語句が見つかれば最後の区切り記号の位置に null 文字を設定し，語句の最初の文 
字へのポインタを返す。見つからなければ NULL を返す。 

注 意—— strtok 関数は与えられた打/かぎの領域を書き換えるので，元のデータが必要な場 

合は自分で保存しておく必要がある。1文字は1バイトを意味する。 

規 格—— ANSI C ， P 0 SIX .1, XPG 3, AES / OS ， SYSV 

関連項目- memchr , strchr , strcspn , strpbrk , strrchr , strsDn , strstr 
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strtol 


用 途——文字列を long 型整数に変換する。 

書 式- #include < stdlib . h > 

long strto 丄 （const cnar * nptr , chax ** endptr , mt radix ); 

解 説—— strtol 関数は即びで指定された文字列を，まず3つの部分文字列，すなわち先 

頭の空白部分，整定数部分，認識不能部分（終端の null 文字を含む）に分割する。 
strtol 関数はこれらの部分文字列のうち，整定数部分の文字列を，⑺也 c で指定 
した値を基数として long 型整数に変換し，その値を返す。 

整定数部分は符号（省略可能）から始まり，基数が 2 〜 10 ならば〇〜 9 の文字を， 
また基数が 10 〜 36 ならばこれに加えて A 〜 Z および a 〜 z の文字が数値とし 
て認識される。 

もし基数 m ゴ /ズが 0 の場合，入力文字列の基数は8， 10，16 のいずれかであり， 
文字列の特徴から動的に決定される。すなわち， 01 〜 07 から始まれば8， Ox か 
ら始まれば 16 ， それ以外なら 10 である。また基数が 16 の場合は，接頭辞 Ox も 
数値の一部として認識される。 

ただし数値の最後の u ， U ， 1, L などの unsigned 型指定文字や 10 ng 型指定文 
字は，数値としては認識されないので注意すること。 

伙办びが NULL でない場合は，⑼办びに最後の認識不能部分へのポインタを格納 
する。この部分は終端の null 文字を含むので，1文字以上である。 

戻り値一変換した結果を返す。ただし変換結果が long 型で表現しきれない場合は，符号 
に応じて L 0 NG _ MAX あるいは L 0 NG _ MIN を返し，変数 errno にその原因を示すエ 
ラーコードを設定する。 

«/7びが空文字であったり，すべて空白だったり，認識不能文字だったりして整定 
数部分の文字列が見つからない場合変換は行われず，〇を返す。また，このとき 
endptr {こ 叩びの値が格納される 0 

• ERANGE 変換結果が long 型で表現することができない 

注 意 - LIBC は C ロケールしかサポートしていない。 

規 格一 Project LIBC Group , ANSI C ， XPG 3, AES / OS , SYSV 
関連項目- atof , atoi , atol , strtod , strtoul 
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ライブラリー第 2 部 


strtoul 


用 途-文字列を unsigned long 型整数に変換する。 

書 式- # include < stdlib . h > 

unsigned long strtoul (const char * nptr , char ** endptr , 

int radix ); 

解 説—— strtmil 関数は/1/?びで指定された文字列を，まず3つの部分文字列，すなわち先 

頭の空白部分，整定数部分，認識不能部分（終端の null 文字を含む）に分割する。 
strtoul 関数はこれらの部分文字列のうち，整定数部分の文字列を， m め x で指 
定した値を基数として unsigned 101 ig 型整数に変換し，その値を返す。 

整定数部分は符号（省略可能）から始まり，基数が2〜10ならば〇〜9の文字を， 
また基数が10〜36ならばこれに加えて A 〜 Z および a 〜 z の文字が数値とし 
て認識される。 

もし基数 m め； c が0の場合は，入力文字列の基数は8,10，16のいずれかであり， 
文字列の特徴から動的に決定される。すなわち，01〜07から始まれば8， Ox か 
ら始まれば16，それ以外なら10である。また基数が16の場合は，接頭辞 Ox も 
数値の一部として認識される。 

ただし数値の最後の u ， U ， 1， L などの皿 signed 型指定文字や long 型指定文 
字および負の符号“-”は，数値としては認識されないので注意すること。 

⑼办ひが NULL でない場合は，⑼办かに最後の認識不能部分へのボインタを格納 
する。この部分は終端の null 文字を含むので，1文字以上である。 

戻り値-変換した結果を返す。ただし変換結果が unsigned long 型で表現しきれない場 

合は UL 0 NG _ MAX を返し，変数 errno にその原因を示すエラーコードを設定する 0 

叩びが空文字であったり，すべて空白だったり，認識不能文字だったりして整定 
数部分の文字列が見つからない場合変換は行われず，〇を返す。また，このとき 
endptr には ひの値が格納される。 


• ERANGE 変換結果が unsigned long 型で表現することができない 

注 意——は C ロケールしかサポートしていない。 

規格 —— Project LIBC Group , ANSI C , XPG 3, AES / OS ， SYSV 
関連項目- atof , atoi , atol , strtod , strtol 
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strupr 


用 途——文字列を大文字に変換する。 

書 式 - - #include く string . h > 

char * strupr (char * stnng ); 

解 説一 strupr 関数は打/か尽が指す文字列を先頭から調べ，現在のロケールの LC—CTYPE 
カテゴリをもとに小文字を大文字に変換する。処理は null 文字を検出した時点で 
終了する。 

戻り値-へのポインタを返す。 

注 意—— 1/5(7 は C ロケールしかサポートしていない。1文字は1バイトを意味する。 

規 格- Project LIBC Group ， MS-C 7.0 

関連項目- strlwr , strnset , strrev , strset 



347 






ライブラリー第 2 部 


strxrrm 


用 途——2つの文字列をロケールを用いて指定文字数だけコピーする。 

書 式- #include く string . h > 

size_t strxfrm (char * stringl,const char * string2 , size_t n ); 

解 説- strxfrm 関数は打/7>7尽2が指す文字列の最初から /2 文字を，現在のロケールの 

LC—COLLATE カテゴリをもとに変換し， 於 / か尽 / の指す領域にコピーする。コピーは 
null 文字が検出されるか，文字コピーした時点で終了する。 打 /*/« ざ 2 末尾の null 
文字も変換の対象となりうる。また/！が 〇 の場合は， が /7 せ 7 は NULL でもよい。 

戻り値——変換された文字のバイト数 （ mill 文字は含まない）を返すが，《が0の場合は単に 
string 2 の長さを返す。 

注 意——領域が重なっていた場合の動作は未定義である 。また stringl は， 打/を変換 

した文字列を格納するのに十分な領域を指していなければならない。 strxfrm 関 
数は C ロケールにしか対応していないため，基本的には strncpy 関数と同じで 
ある。1文字は1バイトを意味する。 

規 格 —— Project LIBC Group , ANSI C ， XPG 3, AES / OS ， SYSV 
関連項目- strcoll , strlwr , strupr 
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swab 


用 途——文字を交換する。 

書 式' - #include <stnng.h> 

void swao (const char *src, char *dst, size_t n) 

解 説 —— swab 関数は贾が指す領域から《バイトを如が指す領域にコピーし，隣り合っ 

た偶数パネトと奇数バイトを入れ換える。《が偶数でない場合は， A2 を越えない 
最大の偶数に丸められる。 

戻り値 一 なし。 

注 意-^-領域が重なっていた場合の動作は未定義である。 swab 関数は Big-Endian と 

Little-Endian との マシン 間で，バイナリデータを転送するのに用いられる。 1 
文字は1バイトを意味する。 

規 格—— P 0 SIX .1，4.3 BSD 

関連項目- memcpy 
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symlink 


用 途——シンボリックリンクファイルを作成する。 

書式 -# include <dos .h> 

int svmlink (const char *src, const char *dst); 

解 説—— symlink 関数は，リンク先として vc を指すようなシンボリックリンクファイル 
ゴ於を作成する。ただし，ゴ对と同名のファイルが存在する場合は失敗する。 

戻り値——正常にシンボリックリンクファイルができた場合は〇を返し，失敗した場合は一1 
を返して，変数 errno にその原因を示す エラーコー ドを設定する 0 

• EEXIST ゴ於がすでに存在している 

• EL00P シンボリックリンクのネストが深すぎるか，またはループして 

いる 

• EN0SPC ディスタがいっぱいである 

• ENOSYS lndrv が常駐していない 

注 意一 symlink 関数の動作はすべて lndrv に依存するため， lndrv 以外のシンボリッ 
クリンクドライバでは使用することができない。また将来， lndrv が変更された 
りしても動作しなくなる可能性がある。 

規 格一 Project LIBC Group , AES / OS 、4.3 BSD 

関連項目 - _dos_importlnenv, _dos_lfiles, _dos_readlink, readlink 
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sysconf 


用 途ーシステムに関する情報を取り出す。 

書 瓦- #include < unistd . h > 

long sysconf (mt name ); 


解 説—— sysconf 関数は現在のシステム（およびライブラリ）に関連する情報を取得し， 

ユーザアプリケーシヨンに対してシステム設定値などを得る手段を与える。どの 
設定値を調べるかについては，似/財で指定する0 こ指定することができる 

マクロ値と求める設定値の一覧は次のとおり。 


• _ SC _ ARG_MAX 

• _ SC _ CHILD_MAX 

• _ SC _ CLK_TCK 

• _ SC _ NGROUPS_MAX 

• _ SC _ OPEN_MAX 

• _ SC _ J 0 B _ C 0 NTR 0 L 

• _ SC _ SAVED_IDS 

• _ SC_VERSION 


• _ SC _ X 0 PEN 一 VERSION 

• _ SCJVTEXIT_MAX 

• _ SCJPAGE_SIZE 

• _ SC _ AES _ OS_VERSION 

• _ SC _ PR 0 J _ VERSI 0 N 


exec 関数に渡すことができる引数の最大値 

1ユーザ当たりの子プロセスの最大数（参考値） 

1秒当たりのクロックティック 

1プロセス当たりの予備グループ ID の最大数 

オープンできるファイルハンドルの最大数 

ジョブコントロールをサポートしているか否か 

SAVED ID をサポートしているか否か 

P0SIX.1 のバージョン番号 

パスワードの最大長 

XPG3 のバージョ ン番号 

atexit 関数で登録できる関数の最大数 

1 ページのページ サイズ 

AES/OS のバージョ ン番号 

ライブラリのバージョン番号 


戻り値——正常に情報を取得できた場合はその値を返し，失敗した場合には一1を返して，変 
数 errno にその原因を示す エラーコー ドを設定する。 

• EINVAL 不正な mzwe を指定した 



互換性—— l / SC では上記（詳細は 〈limits . h > を参照）の制限値は可変ではなく，すべて固 
定である。 

規格一 P0SIX.1 、 XPG3, AES/OS，SYSV 
関連項目- fpathconf , pathconf 
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system 


用 途—シヱルコマンドを実行する。 

僅 式 - # include < stdlib . h > 

mt system vconst char * command ); 
extern int _ keep _ cwd _ on _ exec ; 

解 説- system 関数は， com / wa /2 ゴで指定されたコマンドをシェルに与え，そのコマンド 

を端末から入力したかのように実行させる。ゴに含まれる文字列は，通 
常，シェルにとって意味のある文字（パイプやりダイレクトなど）を含むことがで 
きる。また， ccwiwam/ が NULL あるいは空文字を指していれば，シヱルを対話的 
シェル （ Jr ^ erac ぬ ; e shell ) と して起動する 0 


system 関数を実行したプログラムは，子プロセスであるシヱル，およびそのシェ 
ルから実行されたプログラムの実行が終了するまで停止する。 

起動するシヱルは対話的に起動するかどうかによって変更することができる。 

•対話的 環境変数 SHELL の指すプログラム。シェルに対する先行引数 

(後述）は環境変数 SHELL —0 PT から取得し，シヱルのタイプ（後 
述）は環境変数 SHELLTYPE から取得する 
•非対話的 環境変数 SYSTEM - SHELL の指すプログラム。シェルに対する先 

行引数は環境変数 SYSTEM _ SHELL _ OPT から取得し，シェルの夕 
イプは環境変数 SYSTEM _ SHELLTYPE から取得する 
ただし環境変数 SYSTEM - SHELL が定義されていない場合，シェ 
ル/先行弓 I 数/シヱルタイプは対話的シヱルの場合と同様に，そ 
れぞれ環境変数 SHELL ， SHELL - OPT , SHELLTYPE が使われる。 

〇 シ I ルのタイプ 

シェルの起動方法はシェルのタイプが“ COMMAND . X ”タイプか， UNIX タイ 

プかによって異なる。 system 関数は，起動するシヱルのタイプを以下のよう 

にして判定する。 

1. 環境変数 SHELLTYPE (非対話的シェルの場合は， SYSTEM _ SHELLTYPE ) の 
値が “ COMMAND ” ならば “ COMMAND . X ”タイプ， “ UNIX ” あるいはそれ以外 
ならば UNIX タイプとする。 

2. 環境変数 SHELLTYPE が未定義の場合，環境変数 SHELL (非対話的シェ 
ルの場合は SYSTEM - SHELL ) が未定義ならば “COMMAND • X ”タイプ，環境 
変数 SHELL の設定の末尾が “ command ” あるいは “ command . x ” ならば 
“ COMMAND . X ”タイプ，それ以外は UNIX タイプとする（ただし文字列 
の比較は，大文字/小文字を無視して行われる）。 
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〇非対話的シェルの起動 


Chapter 1— C 標準関数ライブラリ 


1. “COMMAND.X” タイプシェルの場合，以下のような コマンドラインを 
Human 68 k で規定されている通常の方法で子プロセスに渡す。 

COMMAND /C command 

2. UNIX タイプシェル（たとえば “ fish ”） の場合，以下のような コマンド 
ライ ンを HUPAIR で規定された仕様にしたがって エンコードし， 子プ 
ロセスに 渡す （comma/? ゴは 単一の 引数 （argv[ 2 ] ) として渡される）。 

iish -c command 

この“/ C ” や“- c ” は，前述の「シェルに対する先行引数」を設定する環境変 
数 SHELL—0PT (非対話的シヱルの場合は SYSTEM_SHELL_OPT) によって変更す 
ることができる。 

戻り値——正常に実行できた場合はシヱルの終了コードを返し，失敗した場合には 127 <<8 
(32512) を返して，変数 errno にその原因を示すエラーコードを設定する。 

• E2BIG 引数列が多すぎる 

• EN0ENT シェルが見つからない 

• EL00P シンボリックリンクのネストが深すぎるか，またはループしている 

• EN0MEM メモリが足りなくなった 


注 意——環境変数 SHELL が未定義ならば， “ C 0 MMAND . X ” がシヱルとして使われる。 

通常，環境変数 SHELL にはシェルの ファイルネームをフルパスで 設定するが，そ 
うでない 場合には環境変数 path に設定されたディレクトリが検索され，最初に 
見つかったものを対象とする。 

system 関数は シヱ ルを起動する際にカレントディレクトリを保存する。これを避 
けたい場合には，変数 _ keep _ cwd _ on _ exec に0を設定すること。また system 関 
数は， シヱ ルを起動する際に標準ファイル ハンドル （0 〜 句をす ベて 保存する。 

system 関数を非対話的に使うプログラムは，なるべく起動するシェルに依存し 
ないようなコマンドラインを渡すべきである。 



互換性—— UNIX では， system 問数は環境変数 SHELL の設定に関わらず “/ bin / sh ” を 
起動する。もしも同じような環境にしたいのならば，環境変数 SYSTEM _ SHELL ， 
SYSTEM _ SHELL _ GPT , SYSTEM_SHELLTYPE で実現でさる0 

規 格一 ANSI C , XPG 3、 AES / OS , 4.3 BSD ， SYSV 

関埋項目- SDawnve, spawnvp 
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tobslash 


用 途ーパス名に含まれるパス区切り記号をバックスラッシュに変換する。 

書 式-# include く sys/xglob .h> 

chax *_tobslash (char *path); 

解 説 一 -tobslash 関数は path で 指定された パス 名に含まれる すべての パス区切り記号を, 

ハ♦ックスラッシュ“に変換する0 

戻り値——を返す。 

注 意—— -tobslash 関数はライブラリの内部関数なので，移植性を考慮するならば使用し 
ないこと。 

規 格- Project LIBC Group 

関連項目- .toslash 
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—toiower 


用 途—大文字を小文字に変換する。 

書 式- #include < ctype . h > 

int _t 〇丄 ower ^mt c ); 

解 説一 -toiower マクロは c で指定された文字を小文字に変換する。これは toiower 関 

数とは異なり，変換は現在のロケールに影響されない。 

戻り値——7ビット ASCII 文字コードにしたがい， c + 0 x 20 を返す。 

注 意- c が大文字でなかった場合の動作は未定義である。また， .toiower はつねにマク 

口として定義されるので，関数としての実体は存在しない。マクロに対する引数 
が副作用を伴わないように注意すること。 

規 格一 XPG 3, AES / OS ，4.3 BSD , 

関埋項目- toiower , _ toupper , toupper 
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tosiash 


用 途ーパス名に含まれるパス区切り記号をすべてスラッシュに変換する。 

書 式'- #include く sys / xglob . h > 

char *_toslash (char * path ); 

解 説一 _ toslash 関数は/ 7 如 / z で指定されたパス名に含まれるすべてのパス区切り記号を， 

スラッシュ“/”に変換する。 

戻り値一/^认を返す。 

注 意—— - tosiash 関数はライブラリの内部関数なので，移植性を考慮するならば使用し 
ないこと。 

規 格- Project LIBC Group 

関連項目- _tobslash 
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—toupper 


用 途——小文字を大文字に変換する。 

書 式- #include く ctype . li > 

int .toupper (mt c ); 

解 説—— - toupper マクロは c で指定された文字を小文字に変換する。 — toupper は toupper 

関数とは異なり，変換は現在のロケールに影響されない。 

戻り値——7ビット ASCII 文字コードにしたがい， c -0 x 20 を返す。 

注 意—— c が小文字でなかった場合の動作は未定義である。また， - toupper はつねにマク 

口として定義されるので，関数としての実体は存在しない。マクロに対する引数 
が副作用を伴わないように注意すること。 

規 格—— XPG 3, AES / OS ，4.3 BSD，SYSV 

関連項目- jtolower ， tolower , toupper 
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tan 


用 途-正接 Mn (; r ) を求める。 

書 式- #include < math . h > 

double tan (double x ); 

#include < sys / xmath . h > 
double _ f_tan (double x ); 
double _ fe_tan (double x ); 
double _ fpu_tan (double x ); 

解 説—— tan 関数は； c (単位：ラジアン）の正接（タンジェント）を求める。各関数はそれぞ 

れ次のように動作する。 

• tan 数値演算コプロセツザが使用できる場合は数値演算コプロセッサ 

を直接ドライブし，使用できない場合は FLOAT パッケージを呼 
び出す 

• _ f_tan 数値演算コプロセッサ命令を直接ドライブする 

• _ fe_tan FLOAT パッケージを呼び出す 

• _ fpu_tan I / O 数値演算コプロセッサを直接ドライブする 

戻り値——正しく値が求められた場合， tan 関数は； c の正接を返す。もし； c が非数 （ NaN ) な 
らば変数 errno に EDOM を設定して同じく非数を返し，それ以外のエラーでは変 
数 errno に ERANGE を設定して計算結果を返す。ただし計算結果は不正確な値に 
なる。 

• EDOM ズの値が非数 

• ERANGE 計算結果がオーバーフロー/アンダーフロー，またはズの値が大 

きく計算結果の有効桁が一部失われる場合，または; c の値が非常 
に大きくて計算結果の有効桁が完全に失われる場合 

注 意一を読み込む前に， __ DIRECT _ FLOAT _ j ^ 定義されているときは tan は 
_ fe _ tan の別名となり， __ DIRECT _ IOFPU __ が定義されているときは tan は _ fpu_tan 
の別名となる。また， __ DIRECT _ FPU __ が定義されているときは tan は _ f _ tan の別 
名となる。 

数値演算コプロセッサの場合のみ， ERANGE が設定される。 
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規 格 —— Project UBC Group，ANSI C ， POSIX . l , XPG 3, AES / OS ， 

SYSV 

関連項目- at an，isnan 


4.3 BSD , 
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tanh 


用 途——双曲正接 ian / i ( x ) を求める。 


書 式- # include < math . h > 

double tanh (double x ); 

#include < sys / xmath . h > 
double _ f_tanh (double x ); 
double _ fe_tanh (double x ); 
double _ fpu_tanh (double x ); 

解 説—— tanh 関数は； c の双曲正接 （ハイ パボリックタンジェント）を求める。各関数はそ 

れぞれ次のように動作する。 


• tanh 数値演算コプロセッサが使用できる場合は数値演算コブロセッ 

サを直接ドライブし，使用できない場合は FLOAT パッケージを 
呼び出す 

• _f _tanh 数値演算コプロセッサ命令を直接ドライブする 

• _ fe_tanh FLOAT パッケージを呼び出す 

• _ f P u_tanh I / O 数値演算コプロセッサを直接ドライブする 


戻り値——正しく値が求められた場合は JC の双曲正接を返す。もし； C が非数 （ NaN ) ならば， 
変数 eixno に EDOM を設定して同じく非数を返す。 

• EDOM JC の値が非数 


注 意一 < mat 11.1 1 > を読み込む前に， __ DIRECT _ FLOAT __# 定義されているときは tanh 

は _ fe _ tanh の別名となり， __ DIRECT _ IOFPU __ が定義されているときは tanh は 
_ fpu _ tanh の別名となる。また， __ DIRECT _ FPU __ が定義されているときは tanh は 
_ f _ tanh の別名となる。 

規 格 —— Project LIBC Group , ANSI C , POSIX . l , XPG 3, AES / OS , 4.3 BSD , 
SYSV 

関連項目- at an , isnan，tan 
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tell 


用 途—ファイルポインタの位置を調べる。 

書 式- #include く皿 istd . li > 

long tell (int fildes ); 

解 説—— tell 関数は fildes で指定したファイルハンドルのファイルポインタの位置を求め， 
その値を返す。 

戻り値——正常に取得できた場合は〇を返し，失敗した場合には一1を返して，変数 errno 
にその原因を示すエラーコードを設定する。 

• EBADF 不正な fildes を 指定した 

注 意一ここでいうファイルボインタとは，ファイルハンドルを通して低水準入出力にお 

けるファイルボインタのことであり， stdio ライブラリのファイルボインタと混 
同しないように注意すること。 

規 格—— 4.3 BSD , SYSV 

関連項目- fgetpos , fseek ， fsetpos , lseek 
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telldir 


用 途——ディレクトリストリームのボインタ位置を返す。 

書 式- # include く dirent . h > 

long telldir (DIR * dirp ); 

解 説—— telldir 関数は，ゴか/7が指すディレクトリストリー厶の現在のボインタ位置を 

返す。 

戻り値——正常に位置を求められた場合はその位置を返し，失敗した場合には一1を返して， 
変数 errno にその原因を示すエラーコードを設定する。 

• EPERM 不正なディレクトリストリームを指定した 

規 格 —— Project LIBC Group ， POSIX . l , XPG 3, AES / OS , 4.3 BSD , SYSV 
関連項目^- closedir , readdir , rewinddir , seekdir , telldir 
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tempnam 


用 途—テンポラリファイル名を作成する。 

•rf 式- #include < stdio . h > 

char *tempnam 〈const char * dir , const char * prefix ；; 

解 説- tempnam 関数はゴ /> と prefix をもとにして，テンポラリファイル名を作成する。 

dir はテンポラ、) ファイルを作成するディレクトリを指定し， prefix には T プ、) 
ケーション固有のプレフィクス文字（先頭5文字まで使用される）を指定する。も 
しゴかが NULL だったり，ゴ z > に指定したディレクトリが存在しなかったりして書 
き込みできない場合は，代わりに P-tmpdir が使用される。 tempnam 関数はこれ 
らを使ってテンポラリファイルのテンプレートを作成し，最終的には mktemp 関 
数を用いて実際のテンポラリファイル名を得る。 

戻り値——正常にテンポラリファイル名を作成できた場合はそれを格納する領域を確保し， 
そこに結果を格納してからそのポインタを返す。失敗した場合は NULL を返し，変 
数 errno にその原因を示すエラーコードを設定する。 

• EN 0 MEM メモリが足りなくなった 

注 意 —— tempnam 関数が返したボインタが指す領域は，ユーザが責任をもって解放しなけ 

ればならない。また， tempnam 関数はファイル名を作成するだけであり，実際に 
ファイルは作成されない。 

規 格—— XPG 3, AES / OS、SYSV 

関連項目- ere at , f open , free , malloc ， mktemp , open ， tmpfile，tmpnam 
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用 途——現在時刻を取得する。 

書 式- # include <time . h > 

time ( time_t * tp ); 

解 説一 time 関数は，1970年 1 月 1 日（エポックタイム）から今現在までの経過秒数（暦 

時間）を求めてその値を返すとともに，もしも印が NULL でないなら卬が指す領 
域にもその結果を格納する。 

戻り値——正常に求めることができた場合は今現在までの経過秒数を，失敗した場合は一1 
を返す。 

規 格 —— ansi C, POSIX.l, XPG3, AES/OS ， 4.3BSD，SYSV 

関連項目- clock , difftime , mktime 
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tmpfile 


用 途——テンポラリファイルを作成する。 

書 式- #include < stdio . h > 

FILE *tmpfile ( void ); 

解 説—— tmpfile 関数はテンポラリファイルを作成し，それに対応するファイルストリー 

厶を更新モード“ w +” で割り当てる。なお，このテンポラリファイルは fclose 関 
数によってクローズされると，自動的に削除される。 

戻り値一正常に作成できた場合はそのストリームへのポインタを返し，失敗した場合は 
NULL を返して，変数 errno にその原因を示すエラーコードを設定する。 


• EMFILE これ以上ファイルをオープンできない 

• EN 0 SPC ディスクがいっぱいである 

• EN 0 MEM メモリが足りなくなった 

互換性——テンポラリファイルは，デフォルトではテキストモードでオープンされる。設定 
を変更したい場合は，あらかじめ: fmode 関数でデフォルトの変換モードを設定し 
ておかなければならない。 

規 格 —— ANSI C , POSIX . l , XPG 3, AES / OS , SYSV 

関連項目- fmode , fopen , tempnam , tmpnam , unlink 

変 更一従来ではテンポラリファイルをテキストモードでオープンしていたが，現在の 

L 7 BC ではバイナリモードでオーブンされる0 
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tmmiam 


用 途——テンポラリファイルのファイル名を作成する。 

書 式-# include <stdio .h> 

char *tmpnam (.char *s); 

解 説一 tmpnam 関数はテンポラリファイルのファイル名を作成し，その結果をが指す領 

域に格納する。ファイル名はパス名として有効であり，すでに存在しているファ 
イル名とは決して一致しない。 

tmpnam 関数は同じプロセスから呼び出された場合，最低 TMPJ1AX 回は異なるファ 
イル名を作成することができるが，それを越えた場合には，必ずしもユニーク 
になるとは限らない（しかし現実的には，重なることはない)。なお， TMP_MAX は 
<stdio.h> に定義されている。 

戻り値——正常にファイル名を作成できた場合， *5 が NULL でなければが指す領域に， NULL 
ならば関数内部の静的領域にそれぞれ格納され，その領域へのポインタを返す。 
もし失敗した場合は NULL を返し，変数 errno にその原因を示すエラーコードを 
設定する。 

• EINVAL ユニークなファイル 名の作成に失敗した 

注 意——関数内部の静的領域を使用する場合，その結果は関数を呼び出すたびに上書きさ 

れることに注意すること。また S に NULL でない値を指定する場合には， S は最低 
でも L_tmpnam バイトの領域を指していなければならない。なお， L_tmpnam は 
く stdio.h> に定義されている。 

規 格一 ANSI C ， POSIX .1 , XPG 3, AES / OS , SYiSF 
関連項目- fopen, open, tempnam, tmpflie, unlink 
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toascn 


用 途一7ビット ASCII 文字に変換する。 

書 jC - #include <ctype . h > 

int toascii (int c ); 

解 説一 toascii 関数は c を 7 ビット ASCII 文字コードに変換する。 

戻り値- c &127を返す。 

注 意——通常， toascii 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義 
されると実体をもつ関数となる。 toascii 関数がマクロとして展開される場合は， 
引数が副作用を伴わないように注意すること。 

規 格—— XPG 3、 AES / OS ，4.3 BSD，SYSV 

関連項目- isascii 
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toiso 


用 途——8ビット ISO 文字に変換する。 

# -# include く ctvpe.n 〉 

int toiso ^int c ノ； 

解 説—— toiso 関数は C を 8 ビット ISO 文字コードに変換する。 

戻り値- c &: 255を返す。 

注 意——通常， toiso 関数はマクロとして定義されるが， __NO_CTYPE_INLINE__ が定義され 
ると実体をもつ関数となる。 toiso 関数がマクロとして展開される場合は，引数 
が副作用を伴わないように注意すること。 

規 格- Project LIBC Group 

関連項目- isascii 
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tolower 


用 途—大文字を小文字に変換する。 

書エぐ- # inc 丄 ude < ctype . h > 

int to 丄 ower 、int c ); 

解 説一 tolower 関数は c で指定された文字を，現在のロケールの LC - CTYPE カテゴリに 

したがって大文字から小文字に変換する。ただし，変換は大文字に対してのみ行 
われ，それ以外の文字は変化しない。 

戻り値—— c を小文字に変換した文字を返す。 

注 意一通常， tolower 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義 
されると実体をもつ関数となる。 tolower 関数がマクロとして展開される場合は， 
引数が副作用を伴わないように注意すること。 

LIBC は C ロケールしかサボートしていない。 

規 格 —— ANSI C 、 P 0 SIX .1， XPG 3, AES / OS ， 4.3 BSD , SYSV 
関埋項目 - tolower , _ toupper , toupper 



369 






ライブラリー第 2 部 


toupper 


用 途 —小文字を大文字に変換する。 

書 式-# include <ctype . h > 

mt toupper ^mt c ); 

解 説 —— touppei •関数は c で指定された文字を，現在の ロケ _ルの LC—CTYPE カテゴリに 

したがって小文字から大文字に変換する。ただし，変換は小文字に対してのみ行 
われ，それ以外の文字は変化しない。 

戻り値 一 C を大文字に変換した文字を返す。 

注 意 ——通常， toxipper 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義 
されると実体をもつ関数となる。 toupper 関数がマクロとして展開される場合は, 
引数が副作用を伴わないように注意すること。 

は C ロケールしかサポートしていない。 

規 格 一 ANSI C ， P 0 SIX .1, XPG 3, AES / OS , 4.3 BSD，SYSV 

関連項目 - - tolower , tolower — toupper , 
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truncate 


用 途ーファイルの長さを変更する。 

式 - #inc 丄 ude <unistd.h> 

int truncate ^ const char *Dath , off _t len); 

解 説- truncate 関数は/?が / z で指定したファイルの長さを， len バイ トに変更する。も 

し/抓が現在のファイル長よりも短い場合は，その間のデータはすべて捨てられ 
る。しかし反対に長い場合は，その間のデータはすべて0で埋められる。 

ただし， tr 皿 cate 関数は キャラクタデバイスに 対しては動作しない。またファ 
イルは書き込み可能であること。 

戻り値——正常に変更できた場合は0を返し，失敗した場合には 一1 を返して，変数 errno 
にその原因を示すエラーコードを設定する。 

• ENOENT path で指定したファイルが存在しない 

• ER0FS リードオンリーファイルシステムである 

• EL00P シンボリックリンクのネストが深すぎるか，またはループしている 

規 格—— AES/OS 

関連項目 - chsize，ere at, f truncate，open 
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ttyname 


用 途—端末のデバイス名を調べる。 

書 式- # include < unistd . h > 

char *ttyname tint flldes ); 

解 説—— ttyname 関数は，ガゴ打で指定したファイルハンドルが指すファイルが端末デバ 

イス（キャラクタデバイス）であるかどうかを調べ，もし端末デバイスであればそ 
のデバイス名を返す。 

戻り値一端末デバイスならばその名前へのポインタを返し，端末デバイスでなければ NULL 
を返して，変数 errno にその原因を示すエラーコードを設定する 0 

• EBADF 不正な fildes を指定した 

• ENDTTY 端末デバイスではない 

注 意——結果は関数内部の静的領域に格納されるため，関数を呼び出すたびに内容が上書 

きされることに注意すること。 

規 格一 POSIX . l , XPG 3, AES / OS , 4.3 BSD , SYSV 

関連項目- isatty 
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tzset 


用 途——タイムゾーン情報（地域時間情報）を初期化する。 

•rf 式- #mclude <time . h > 

void tzset ( void ); 

解 説—— tzset 関数は環境変数 TZ を参照して，協定世界時 （ UTC ) と地域時間を相互に変 

換するための地域時間情報を初期化し，地域時間名を示す変数 tznarne ， 時差を 
示す変数 timezone ， 夏時間を示す変数 daylight を設定する。 

変数 tzname は2つの要素をもち， tzname [0] が通常の地域時間名 ， tzname [1] 
が夏時間の期間中の地域時間名を表す。 

変数 daylight は夏時間の補正を行うかどうかを表している。もし変数 daylight 
が0ならば夏時間の期間中ではなく（補正は行われない)，0以外の値ならば夏時 
間の期間中（補正が行われる）である。 


変数 timezone は地域時間と協定世界時の時差を表しており，時差士〇の地域から 
西回りに計算した時差の秒数である。時差が+9時間の日本一帯の地域であれば， 
変数 timezone は一32400になる。時差とは符合が逆になることに注意すること 0 

環境変数 TZ の設定フォーマットは POSIX .1 に規定されたものを採用しており， 


TZ=stdoff set [dst [ offset ] [start [/ time ] , end [/ time ]]] 


のようなフォーマットである。左から順に， 


• std 

• offset 

• dst 

• offset 

• start [/ time ] 

• end [/ time ] 


地域時間の地域時間帯名称 （3 文字またはそれ以上） 
通常の地域時間から協定世界時への補正値で，形式 

は [ sign ] hh L : mm [: ss ]] 

地域時間の夏時間の期間中の地域時間帯名称 （3 文字また 
はそれ以上） 

夏時間の期間中の地域時間から協定世界時への補正値で， 
形式は [ sign ] hh [: mm [: ss ]] 

夏時間の開始日時 
夏時間の終了日時 


を表している。このうち，夏時間の開始/終了日時のフォーマットは次の2通り 
である。 


• [ J ] n [/ hh : mm : ss ] J で始まる場合は Julian 日付とし，閏日はカウン 
卜されない (1 < n < 365) 0 つまり2月28日が 
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n = 59 で， 3 月 1 日が n = 60 となる 0 J で始まら 
ない 場合は0を底とする Julian 日付とする。閏日は 
カウントされる （0 < n < 365) ので，2月29日は 
n = 60 となり3月1日は n = 61 となる 
• Mm . n . d [/hh : mm : dd ] M で始まる場合は m 月の第 ti 週の弟 ^ 日となる 0 

ここで各値の範囲は， 0< d 仝6，1< n < 5, 
1< m <12であり， n が5のときは「その月の最後 
の週の最終日」を表す。また， n が1のときは「そ 
の月の第 d 日目」を表す 。 d = 0 は日曜日を表す 

夏時間の開始/終了時間を指定する/ time 部分は offset フィールドと同じだが， 
符合は識別しない。指定しない場合は02:00:00と解釈される。 

便宜上， std と dst のフィールドは‘：，， V ，または数字を検出した時点 
で完結することにする。つまり， TZ = JST :_ 9 や TZ = JST ,-9 といった指定が可能と 
なる。 

最後に具体例を示す。 

TZ = JST -9 USA +5 :30:25: J 320/02 :00:00, M 12• 5 • 6/02:00:00 

上記の例は，地方時間が JST で協定世界時と -9 時間の差があり，夏時間の期間中 
は時間帯名称が USA に変更し，協定世界時と+5時間30分25秒の差があることを 
示す。また夏時間は，第320日目の2:00:00から12月第5週の土曜日 2 :00:00 
までである。なお念のため補足するが，このような例は実際には存在しない。 

戻り値——なし。 

注 意——環境変数 TZ が設定されない場合，既定値として次の値を設定する。 


tzname [0] = " JST " ; 
tzname [1] = " " ; 

aav 丄 lght =0; 
timezone = -32400; 


互換性——標準のライブラリを利用すると，簡易型の tzset 関数がリンクされる。これは， 
環境変数 TZ を見ず，つねに既定値で設定するものである。もしも，ここで解説 
したフルスペックの tzset 関数を使用したければ，明示的に “ libtz . a ” をリン 
クしなければならない。 




Chapter 1- C 標準関数ライブラリ 


規 格 —— Project LIBC Group ， POSIX . l , XPG 3, AES / OS，SYSV 

関連項目- ctime , localtime , mktime，strftime 

バ グ—— Human 68 k のシステムコールでは地域時間しか取得することができないため, 

この地域時間から見かけ上の協定世界時を求める手順を，日本でしか通用しない 
方法でハードコーディングしている。したがって，日本および日本が属する時間 
帯以外で使用すると，時間が狂ってしまう。 
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umask 


用 途——ファイルモードの新規作成用マスクを設定する。 

書 式 # include < sys/stat . h > 

mode_t umask ( mode_t cmask ); 

解 説—— umask 関数は， cm 似んで指定したファイルマスクをカレントファイルマスクとし 

て設定する。ここで指定したファイルマスクは， creat 関数や open 関数， mkdir 
関数などで新規にファイル，ディレクトリを作成する場合に，それぞれの関数に 
引数として与えられたモードに適用される。デフォルトでは〇である。 

戻り値一以前のカレントファイルマスクを返す。 

規 格 —— Project LIBC Group ， POSIX . l , XPG 3, AES / OS ，4.3 BSD , SYSV 
関連項目- ere at , mkdir , open 
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uname 


用 途ーシステムに関する情報を取り出す。 


書 式'- #include < sys/utsname . h > 

mt uname (struct utsname * name ); 

解 説—— uname 関数は現在のシステム，およびオペレーティングシステムに関する情報を 

取得し， name が指す領域に格納する。 utsname 構造体は次のとおり。 


struct utsname { 


char 

♦sysname; 

/* 

char 

♦nodename; 

/* 

char 

♦release; 

/* 

char 

♦version; 

/* 

char 

♦machine; 

h 


オペレーティングシステムの名前*/ 

ネットワーク上のノード名（ホスト名）*/ 
オペレーティングシステムのリリース番号*/ 
オペレーテイングシステムのバージョン番号*/ 
マシンのハードウェア名*/ 


}; 


上記の項目はそれぞれ次のように求めている。 


• sysname 


• nodename 


• release 


• version 


• machine 


オペレーテイングシステムの名前としてつねに “ Human 6 8 k ” を 
返す 

環境変数 HOST が設定されていればその文字列を，設定されて 
いなければ “ unknown ” を返す 

Human 68 k のメジャーバージョン，たとえば Human 2. 03な 
らば“2” を返す 

Human 68 k の マイナーバー ジ ョン，たとえぱ Human 2 • 03な 
らば“3” を返す 

ライブラリを実行中のマシンが X 68000 ならば “ X 6 8000” を， 
X 68030 ならば “ X 68030” を返す 


戻り値——正常に取得できた場合は〇を返す。エラーはない。 

規 格- Project LIBC Group，POSIX. 1 , XPG3 , AES/OS , SYSV 
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unqetc 


用 途一入カファイルストリームにデータを押し戻す。 

書 式- # include <stdio . h > 

int 1111 getc (int c , FILE * stream ); 

解 説—— ungetc 関数は，で指定された入力用のファイルストリームにごを 

皿 signed char 型に変換してから押し戻す。ただし C に， EOF を指定した場 
合は何も行わない。 

押し戻されたデータは後に続く読み出し操作で最優先に取り出されることになる 
が，あくまでもバッファ上の操作であり，ファイルの実体は一切変更されない。 
また押し戻しが行われた後は，ストリームに設定されていた終端指示子はクリア 
される。 

戻り値——正常に押し戻せた場合は C を返し，失敗した場合は EOF を返す。 

注 意—— ungetc 関数は最低限1バイト （ ZJ 5 C では1幅広文字）を押し戻せることを保証し 

ているが，それ以上は状況によっては押し戻せないことがあるので注意すること。 

規 格 —— ANSI C , POSIX . l , XPG 3、 AES / OS , 4.3 BSD , SYSV 

関連項目- fseek , fsetpos , getc , rewind , setbuf 
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Chapter 1— C 標準関数ライブラリ 


ungetch 


用 途— コンソールにデータを 押し戻す。 

違式- #include < conio . h > 

mt ungetch (int c ); 

解 説一 ungetch 関数はコンソールに対して c で指定した文字を押し戻し，その文字コー 

ドを返す。押し戻された文字は，後で getcli 関数， getclie 関数， cgets 関数な 
どで読み出しが行われた場合に，再度入カデータとして取り出されることにな 
る。 ungetch 関数はつねに コンソールと 直接データをやりとりするので，標準入 
力の状態に左右されることも stdio ライブラリによる バッファ リングの作用も受 
けない。 

戻り値- c を返す。 エラーは ない。 

注 意—— コンソール 用の押し戻しバッファは1バイト分しかない。続けて2回以上皿 getch 

関数を呼び出した場合，データは失われてしまうことになるので注意すること。 

規 格 —— Project LIBC Group，MS-C7.0 

関連項目- cgets , getch , getche , ungetc 
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ライブラリ ー 第2部 


unlink 


用 途——ファイルを削除する。 

書 式- # include < unistd . h > 

int unlink 、 const char * path ); 

解 説一 unlink 関数は， /? がみで指定したファイルを削除する。 path には， 現在 creat 関 

数や open 関数でオープンしているファイルも指定することができるが，その 
場合実際に削除されるのは close 関数でファイルがクローズされたときであり， 
unlink 関数は削除の予約だけを行う 0 

戻り値——正常に削除できた場合は〇を返し，失敗した場合には 一1 を返して，変数 errno 
にその原因を示す エラーコー ドを設定する。 

• ENOENT path で指定したファイルが存在しない 

• EISDIR ディレクトリである 

• ER0FS リードオンリーファイルシステムである 

• EL00P シンボリックリンクのネストが深すぎるか，またはループしている 

注 意- close 関数と unlink 関数は UNIX 上の unlink システムコールをシミュレート 

しているが， Human 68 k のファイルシステムではリンクカウントを保持できな 
いため，つねにカウントを1として扱っている。 

また，その実現方法は完全ではないので，理論的には削除予約したはずのファ 
イルが正しく削除されずに残ってしまうこともあり得る。したがって unlink 関 
数は，ファイルをクローズした後に実行するのが望ましいといえる。 

unlink 関数は path で指定したファイルが現在オープンされているかどうかを調 
ベるが，それは LffiC 内部のテーブルを参照しているにすぎない。したがって， 
DOS コールなどを用いて直接オープンしているファイルに対しては有効ではな 
い。そのようなファイルをオープンしている最中に削除すると， Human 68 k の 
仕様により管理領域が破壊される。 

規 格^— POSIX . l , XPG 3, AES / OS ，4.3 BSD，SYSV 

問連項目 close , remove , rmdir 

変 更——従来では path にディレクトリを指定するとエラーとなっていたが，現在の LIBC 
ではディレクトリを削除するようにした。 
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Chapter 1— C 標準関数ライブラリ 


usleep 


用 途ーマイクロ秒単位のスリープを実行する。 

書式- frinc 丄 ude < unistd . h > 

unsigned int usleep (unsigned int useconds ); 

解 説 - usleep 関数は， ⑽况洲ぬ で指定したマイクロ秒数だけ現在実行中のプロセスを 

スリープさせる。プロセスは指定した時間スリーブするが，シグナルが通知され 
てシグナルハンドラが呼び出された場合はスリーブ状態から復帰する。 

戻り値——指定した時間が経過した場合は0を，途中でシグナルによって中断された場合は 
残りスリーブ時間（マイクロ秒単位）を返す。 

注 意——引数はマイクロ秒単位で指定するが， Human 68 k では i / 100 秒までの精度しか 

ない0 

規 格 —— Project LIBC Group , 4.3 BSD , SYSV 

関連項目- pause , signal , sleep 
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ライブラリー第 2 部 



用 途ーファイルのタイムスタンプを変更する。 

書 式-# include <utime . h > 

int utime (const char * name , struct utimbui * times ); 

解 説—— utime 関数は mz 脱が指すファイルのタイムスタンプ（最終変更日付および最終 

変更時刻）を， times が NULL であれば現時刻に変更し， NULL でなければ times が 
指す構造体の時間に変更する。 utimebuf 構造体は次のとおり 0 

struct utimbuf \ 

time_t actime ; /* 最終アクセス時刻*/ 

time.t modtime; /* 最終更新時刻*/ 

>； 

また構造体メンバは，1970年1月1日 （エポックタイム） から指定時刻までの経 
過秒数で指定する。 

戻り値一正常にタイムスタンプが変更できた場合は〇を返し，失敗した場合は一1を返し 
て，変数 errno にその原因を示すエラーコードを設定する。 

• EINVAL 不正な時間を指定した 

• ENOENT name で指定したファイルが存在しない 

• ENOENT 書き込み禁止ファイルを指定した 

注 意- Human 68 k では actime は無視され， modtime のみが参照される 0 またデイス 

クには UTC ではなく ， JST (日本標準時） で書き込まれる。 

規 格一 POSIX .1 ， XPG 3, AES / OS , 4.3 BSD，SYSV 

関連項目- localtime , time 
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Chapter 1— C 標準関数ライブラリ 


vaara 


用 途一可変長引数リストから引数を1つ取り出す。 


谱 ェく- #inciude < stdarg . h > 

type va_arg ( va_list ap , type ); 

#include < varaxgs . h > 

type va_arg ( va.list ap , type ); 

解 説—— va _ arg は，叩で指定した可変長引数リストから伙时で指定した変数型の引数を 

1つ取り出し，その値を返す。このとき叩は，データのアラインメントや引数の 
スタックへの積み方を考慮して，適切な方法で引数リストにアクセスする。 

なお引数を取り出した後， 叩のボイ ンタは次の引数を取り出すことができるよう 
に進められる。 

戻り値——引数リストからび/祀で指定した変数型のデータを取り出し，その値を返す。同様 
に，戻り値の変数型もび/^型となる。 

注 意-は使用する前に，必ず va _ start で初期化されている必要がある。また， ap の 

値や可変長引数リストの内容が適切でなかった場合， va_arg の戻り値は不定で 
ある。 

く varargs.h 〉 を使用する場合，関数宣言は都合上，スタイルを用いなけれ 
ばならない。 A/V57C 1 スタイルを用いたい場合は，必ずく stdarg.h 〉 の ほうを用 
いること。 

互換性——く varargs . h > は，古いタイプのソースファイルとの互換性のためにだけ用意さ 
れている。通常は，ん〜5/(7規格の < stdarg . ti > に定義されているインタフェイ 
スを用いること。 

またく varargs .h> とく stdarg .li> は，決して同時に用いてはならない 0 


規格—— XPG 3, AES / OS ，4.3 BSD , SYSV 
関連項目 - va_end, va_start 
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ライブラリー第 2 部 


サンプル —— lilSIKg 


く stdarg. h > の使用例 


1: /* 

2: ** 引数に積まれた n 個の文字列をすべて表示する 

3 : ** output (mt n , strl ， s'ti'S t •. . • ， strn ) ， 

4: */ 

5: 

6 : #include <stdio.h> 

7 : #include <stdarg.h> 

8 : 

9 : void output (int n , ...)/* 引数の最後は ... と書く*/ 

10： { 

11: va.list ap; /* 可変長引数リストへのポインタ */ 

12 : char *p; 

13: 

14: /* 引数リストへのアクセスを開始 */ 

15: va_staxt (ap ， n) ; 

16: 

17: /* 引数リストから char * のデータを取り出す */ 

18: while ((p = va_arg (ap, char *)) != (char *) 0) 

19: printf ("string = %s\n", p); 

20 : 

21: /* 引数リストへのアクセスを終わる */ 

22: va_end (ap) ; 

23: > 


サンプル~ riff ™ 


-B 


• く varar 


送 . h > の使用例 


1 : /* 

2: ** 引数に積まれた n 個の文字列をすべて表示する 

3: ** output (mt n, strl,str2, strn); 

4: */ 

5: 

6 : #include <stdio.h> 

( : #include <varargs.h> 

8 : 

9: void output (n, va_alist) /* 引数の最後に va_alist を書く */ 

10: int n; /* varargs.h を使う場合は K&R スタイル */ 

11: va.dcl /* va.alist のための宣言。セミコロンはつけない */ 

12: { 

13: va.list ap; /* 可変長引数リストへのポインタ */ 

14 : char *p; 

15: 

16: /* 引数リストへのアクセスを開始 */ 

17 : va_start (ap) ; 

18: 

19: /* 引数リストから char * のデータを取り出す */ 

20: while ((p = va_arg (ap, char *)) != (char *) 0) 

21 : printf ("string = # /,s\n" , p); 

22 : 

23: /* 引数リストへのアクセスを終わる */ 

24: va_end (ap) ; 

25: > 
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Chapter 1— C 標準関数ライブラリ 


vaend 


用 途一可変長引数リストへのアクセスを終了する。 

書式- #include <stdarg.h> 

void va_end (va_list ap); 

#inc 丄 ude <varargs.h> 
void va_end (va_list ap); 

解 説一 va_end は， ap で指定した可変長引数リストへのアクセスを終わりにし，適切な 

事後処理をする。可変長引数リストへのアクセス方法など，詳細は va_arg を参 
照のこと。 

戻り値一なし。 

注 意—— <varargs . を使用する場合，関数宣言は都合上， K & R スタイルを用いなけれ 

ばならない。 A/VSJC スタイルを用いたい場合は，必ずく stdarg.li> のほうを用 
いること。 

互換性—— く varargs.li> は，古いタイプのソースファイルとの互換性のためにだけ用意さ 
れている。通常は，規格の く stdarg.h 〉 に定義されているインタフェイ 
スを用いること。 

またく varargs.h 〉 とく stdarg.h> は，決して同時に用いてはならない 0 
規 格—— XPG 3, AESIOS 、4.3 BSD，SYSV 

関連項目- va_arg ， va_start 
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ライブラリー第 2 部 


va start 


用 途——可変長引数リストへのアクセスを開始する。 

書式- #include < stdarg . h > 

void va.start ( va_list ap , parmn ;; 

#include < varargs . h > 
void va^start ( va.list ap ); 

解 説-く stdarg . h 〉 を使用する場合， va _ start は/で指定した引数の次からが可 

変長引数リストであるとして ap を初期化し，引数リストへのアクセスができる 
ようにする。 

またく varargs . h 〉 を使用する場合， va _ s " tart は関数宣言で va . alist を指定し 
た位置からが可変長引数リストであるとして耶を初期化し，引数リストへのア 
クセスができるようにする。 

どちらも初期化された後は， va _ arg によって求める引数を取り出すことができ 
る。可変長引数リストへのアクセス方法など，詳細は va _ arg を参照のこと。 

戻り値一なし。 

注 意一< varargs • h 〉 を使用する場合，関数宣言は都合上， K & R スタイルを用いなけれ 

ばならない。ん / VS 7 C スタイルを用いたい場合は，必ずく stdarg . li 〉 のほうを用 
いること。 

互換性- 〈 varargs 上〉は，古いタイプのソースファイルとの互換性のためにだけ用意さ 

れている。通常は， AiVS / C 規格のく stdarg . h 〉 に定義されているインタフェイ 
スを用いること。 

またく varargs . h 〉 とく stdarg . li > は，決して同時に用いてはならない。 

規 格—— XPG 3、 AES / OS ，4.3 BSD , SYSV 

関連項目- va _ arg ， va_end 
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Chapter 1— C 標準関数ライブラリ 


vfprintr 


用 途一可変長引数リストをフォーマット出力する。 

書 式 - #include <stdio.h> 

mt vfpnntf (FILE *stream, const char * format, va_list ap); 

解 説—— vfprintf 関数は/ bmi がで指定した表示フォーマツトにしたがって， a/? で指定し 

た可変長引数リストのデータを於作 am のファイルストリームに出力する。表示 
フォーマツトや機能的な説明については， printf 関数を参照のこと。 

戻り値一正常に出力できた場合はそのバイト数を返し，何らかの エラーに よって失敗した 
場合はストリームのエラー指示子を設定して負の値を返し，変数 errno にその原 
因を示す エラーコー ドを設定する。 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

• EN0SPC デイスクがいっぱいである 

注 意- a/7 は，あらかじめく stdarg.h 〉 やく varargs.h 〉 で定義されているマクロ 

va.start, va_arg, va_end で初期化されていなくてはならない 0 

規 格一 ANSI C, XPG3, AES/OS, SYSV 

関連項目- fprintf , printf , vfprintf, vprintf 
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ライブラリー第 2 部 


vfscanf 


用 途——ファイルストリームから可変長引数リストを用いてフォーマット入力を実行する。 
書 式 - # include <stdio .h> 

int vfscanf (FILE *stream, const chax ^format, va 一 list ap); 

解 説—— vfscanf 関数は介⑽がで指定したフォーマット文字列にしたがって，必要なデー 

夕列を stream のファイ ルストリームから入力し，その結果を <3/?の指す領域に 
格納する。ただし vscanf 関数では，この引数は可変長引数リストから取り出さ 
れる。 

入カフォーマット文字列の指定の仕方や詳細な説明については， fscanf 関数を 
参照のこと。 

戻り値——正常に入力できた場合は実際に入力できた項目数を返し，失敗した場合は EOF を 
返してストリームの エラー 指示子を設定し，変数 errno にその原因を示すエラー 
コードを設定する。 

• EBADF ファイルストリームに関連するファイル ハン ドルがおかしい 

注 意——引数に指定するボインタは，結果を格納するだけの十分な大きさの領域を指して 

いなければならない。 

また ap は ，あらかじめく stdarg.h 〉 や <varargs.il 〉 で 定義 されてるマクロ 
va_start, va_arg, va_end で 初期化されていなくてはならない。 

規 格- Project LIBC Group 

関連項目 - fscanf, scanf ， sscanf ， vscanf, vsscanf 
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Chapter 1— C 標準関数ライブラリ 


vprmtf 


用 途—可変長引数リストをフォーマツト出力する。 

書 式- #include < stdio . h > 

int vprintf (const char * format , va_list aD ); 

解 説—— vprintf 関数は/ brm がで指定した表示フォーマツトにしたがって，叩で指定し 

た可変長引数リストのデータを標準出カストリームに出力する。表示フォーマツ 
卜や機能的な説明については， printf 関数を参照のこと。 

戻り値——正常に出力できた場合はそのバイト数を返し，何らかのエラーによって失敗した 
場合は標準出カストリームのエラー指示子を設定して負の値を返し，変数 errno 
にその原因を示すエラーコードを設定する。 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

• EN0SPC デイスクがいっぱいである 

注 意—— ap は， あらかじめく stdarg . h 〉 や < varargs . li > で定義されているマクロ 
va _ staxt , va _ arg ， va _ end で初期化されていなくてはならない 0 

規 格—— ANSI C , XPG 3, AES / OS , SYSV 

関連項目- printf , vfprintf , vsprintf 



389 






ライブラリー第 2 部 


vscanf 


用 途——標準入カファイルストリームから可変長引数リストを用いてフォーマット入力を 

実行する。 

書 式"- #include < stdio . h > 

int vscanf (const char * format , va 一丄 ist ap ); 

解 説—— vscanf 関数は / omi がで指定したフォーマット文字列にしたがって，必要なデー 

夕列を標準入力に割り当てられたファイルストリームから入力し，その結果を 
叩の指す領域に格納する。ただし vscanf 関数では，この引数は可変長引数リス 
卜から取り出される。 

入カフォーマット文字列の指定の仕方や詳細な説明については， fscanf 関数を 
参照のこと。 

戻り値——正常に入力できた場合は実際に入力した項目数を返し，失敗した場合は EOF を返 
してストリームの エラー 指示子を設定し，変数 errrio にその原因を示す エラー 
コードを設定する。 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

注 意——引数に指定するボインタは，結果を格納するだけの十分な大きさの領域を指して 

いなければならない。 

また ap は， あらかじめく stdarg . h 〉 やく varargs . li > で定義されているマクロ 
va _ start , va _ arg , va _ end で初期化されていなくてはならない。 

規 格 —— Project LIBC Group 

関埋 I 貝目 - fscanf , scanf , sscanf ， vfscanf，vsscanf 
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Chapter 1 -C 標準関数ライブラリ 


vsprintf 


用 途—可変長引数リストをフォーマット出力する。 

書式 - #include <stdio.h> 

mt vsprintf {.char *s, const char *format, va.list ap); 

解 説- vsprintf 関数は/ cm? がで指定した表示フォーマツトにしたがって，即で指定し 

た可変長引数リストのデータを文字列に変換し，その結果を J の指す領域に格納 
する。表示フォーマットや機能的な説明については， printf 関数を参照のこと。 

戻り値——変換したバイト数（終端の mill 文字は含まない）を返す。 

注 意—— J は結果を格納するだけの十分な大きさの領域を指していなければならない。 

また ap は， あら かじめく stdarg.h 〉 やく varargs.h 〉 で定義されているマクロ 
va_start ， va_arg ， va_end で初期化されていなくてはならない。 

規 格—— ANSI C ， XPG 3, AES / OS，SYSV 

関埋項目 - printf, sprintf, vfprintf, vprintf 
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ライブラリー第 2 部 


vsscanf 


用 途——文字列から可変長引数リストを用いてフォーマット入力を実行する。 

書 式-# include く stdio.li> 

int vsscanf (const char *s, const char *format, va.list ap ノ； 

解 説一 vsscanf 関数は/ o/TW がで指定したフォーマット文字列にしたがって，必要なデー 

夕列を J で指定した文字列から入力し，その結果を a /7 の指す領域に格納する。た 
だし vsscanf 関数では，この引数は可変長引数リストから取り出される 0 

入カフォーマット文字列の指定の仕方や詳細な説明については， fscanf 関数を 
参照のこと。 

戻り値——正常に入力できた場合は実際に入力できた項目数を返し，失敗した場合は EOF を 
返す。 

注 意一引数に指定するボインタは，結果を格納するだけの十分な大きさの領域を指して 

いなければならない。 

また a/? は，あらかじめく stdarg.h 〉 やく varargs.h 〉 で 定義されて いるマクロ 
va_start ， va_axg, va_end で 初期化されていなくてはならない。 

規 格一 Project LIBC Group 

関連項目 - fscanf, scanf, sscanf, vfscanf, vscanf 
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Chapter 1 一 C 標準関数ライブラリ 



用 途—— short 型の値の絶対値を取得する。 

書 式^ #include < stdlib . h > 

short wabs (short n ); 

解 説一 wabs 関数は A 2 の絶対値を返す。 

戻り値-の short 型絶対値を返す。 

注 意一通常， wabs 関数はマクロとして定義されるが， __ NO _ STDLIB _ INLINE __ が定義さ 
れた場合には実体をもつ関数となる。 

規 格- Project LIBC Group 

関連項目- abs ， div ， labs , ldiv 
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ライブラリー第 2 部 


wcstombs 


用 途——幅広文字列をマルチバイト文字列に変換する。 

書 式-# include < stdlib . h > 

size_t wcstombs (char * s , const wchar_t * pwcs , size_t n ); 

解 説—— wcstombs 関数は，で指定された幅広文字列をマルチバイト文字列に変換し， 
結果を J が指す領域に格納する。変換は mill 文字に到達するか，バイトを格納 
するまで行われる。 

また，変換は ロケールの LC—CTYPE カテゴリに影響される。もし現在の ロ ケール 
が状態依存体系の文字コードを用いていた場合，変換結果はシフト状態を初期化 
してから格納される。 

戻り値——変換して格納されたバイト数（終端の mill 文字は含まない）を返す。ただし途中で 
不正な幅広文字に出会った場合，変換はそこで中止され， 一 1を返して変数 eixno 
にその原因を示す エラーコー ドを設定する。 

• EINVAL 変換中に不正な幅広文字に出会った 

注 意—— LffiC は C ロケールしかサポートしていない。 

規 格 —— Project LIBC Group , ANSI C , AES / OS , SYSV 
関連寧項- molen , mbstowcs , mbtowc , wctomb 


394 





Chapter 1— C 標準関数ライブラリ 


wctomb 


用 途——幅広文字をマルチバイト文字に変換する。 

書 式- #include < stdlib . h > 

int wctomb (char * s , const wchar.t wchar ); 

解 説—— wctomb 関数は， vvc/zflr で指定された幅広文字をマルチバイト文字に変換し， J が 
指す領域に格納する。 

変換はロケールの LC-CTYPE カテゴリに影響される。もし現在のロケールが状態 
依存体系の文字コードを用いていた場合，に null 文字を指定することで， 
シフト状態を初期化することができる。 

戻り値一 vvc / zar が正しい幅広文字だった場合は，変換したマルチバイト文字を構成するバ 
イト数を返し，不正な幅広文字だった場合は一1を返して，変数 errno にその原 
因を示す エラーコー ドを設定する。 

また S に NULL を指定した場合，現在のロケールの文字コードが状態依存体系で 
あれば0以外の値を，状態依存体系でなければ〇を返す。 

• EINVAL 不正な幅広文字に出会った 

注 意一は C ロケールしかサポートしていない。 

規 格 —— Project LIBC Group , ANSI C , AES / OS，SYSV 

関連項目—— mblen , mbstowcs , mbtowc , wcstombs 
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用 途——ファイルへ書き込む。 

書 式' # include < unistd . h > 

int write (int fildes , const char * buff , unsigned int n ;; 

解 説—— write 関数は，力/ゴ打で指定したファイルハンドルが指すファイルに対して buff 

が指す領域から《バイトを書き込む。書き込み中に何らかのエラーが発生すると， 
write 関数はその時点で処理を中断する。その結果，ファイルポインタは書き込 
んだバイト数分だけ進む。ただし， A 2 が〇だったときは何も行わない。 

ファイルがバイナリモードでオープンされていた場合，データはすべてそのまま 
ファイルに書き込まれるが，テキストモードでオープンされていた場合は，デー 
夕中に含まれるすべての LF を CRLF に変換してから書き込まれる。その結果，正 
常に処理できても戻り値が《を越えることがある。 

戻り値——正常に書き込めた場合は，実際に書き込んだバイト数を返す。何らかのエラーに 
よって失敗した場合には一1を返して，変数 errno にその原因を示すエラーコー 
ドを設定する。 

«が0だった場合は0を返す。 

• EBADF 不正な fldes を指定した 

規 格 一 Project LIBC Group，POSIX.l, XPG3, AES/OS, 4.3BSD, SYSV 
関連項目- fcntl , lseek，open 

変 更-従来では，テキストモードでの write 関数の戻り値は read 関数と同じく LF 

CR , LF 変換の結果によって変化していたが，現在のでは，この変換に関 
係なく指定されたバッファのうち何バイトを書き込めたかを返すようになった。 

従来では K 7，7.0 との互換性に難点があったが，これらの変更により現在 
の1/及 (7 では完全に互換性がある。 
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Chapter 2 

DOS コールライブラリ 


本章には Human 68 k の DOS コールライブラリ の マニュアルを 掲載し 
ます。では従来の XC との互換性を考慮し，名前が異なる以外は基 
本的な動作はすべて同じに作成されています。 

本書では， DOS コールに ついては関数ごとの マニュアルに とどめ，各 
デバイスなどの詳しい説明はしません。詳しく知りたい場合は，他の書 
籍などを參照してください。 
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_dos—allclose 


用 途——オープンしているすべてのファイルをクローズする。 

書 式- # include < sys/dos . h > 

void _ dos_allclose ( void ); 

解 説—— _ dos _ allclose 関数は現在オープンされているファィルをすべて クローズ する 0 
子プロセスが クローズし 忘れたファイルについても同様に クローズす るが，自プ 
ロセスの親プロセス（自プロセスを呼び出したプロセス）がオーブンしたファイル 
については クローズ しない。 

_ dos _ allclose 関数は DOS コール OxFFlF を発行することによって処理される 0 
戻り値-なし。 

注 意- _ dos _ allclose 関数は Human 68 k レベルでファイルをクローズしている 0 した 

がって， stdio ライブラリ （ fopen 関数など）でファイルをオープンしている場合 
は使用してはならない。 

規 格- XC 


398 






Chapter 2—DOS コールライブラリ 




用 途一仮想ドライブ/仮想ディレクトリの割り当てリストの取得/作成/解除を行う。 



mt _ dos_getassign 、const char * buff 1 ,char * buff 2); 
int _ dos_makeassign (const char * buffl , 


const char * buff 2, int mode ); 
int _ dos_rassign (char * buft ;; 


解 説—— — dos — getassign 関数は，仮想ドライブ，仮想ディレクトリの割り当て状況を調 

ベる0 

戻り値により，に次に示す割り当て状況がセットされる。 

• 0 x 40 割り当てが存在しないことを示す。み w ガ7で指定したドライブのカレ 

ントディレクトリを buff 2 へセ ットする 

• 0 x 50 ゐ w 方7をアクセスしたとき，実際にアクセスされるディレクトリが 

buff 2 へそッ トされる 

• 0 x 60 わ w がを実際にアクセスしようとしたとき，アクセスしなくてはなら 

ないディレクトリが buff 2 へそ ットされる 

buffi に _ dos _ makeassign 関数での1番目の引数と同じ内容を指定すると，2番目 
の引数で^*定した内容がゐ_にセットされる。 

_ d 0 SJ nakea SS ign 閨数は仮想ドライブ/仮想ディレクトリの割り当てを行う 0 
mode に指定する値は次のとおり 0 

• 0 x 50 仮想ドライブの割り当てを行う。加^のドライブをアクセスしたと 

き，実際にはゐ《方2のディレクトリがアクセスされる 

• 0 x 60 仮想ディレクトリの割り当てを行う 。 buffi の〒ベ レクトリをアクセ 

スしたとき，方2のドライブがアクセスされる 

_ do S _ ra SS ign 関数は仮想ドライブ/仮想ディレクトリの割り当てを解除する 。 buff 
には- dos _ makeassign 関数の第1引数と同じ内容を指定すること 0 

これら3つの関数は DOS コール 0 xFF 5 F (0 xFF 8 F ) を発行することによって処理 
される。 
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戻り値- _ dos _ getassign 関数は，成功した場合は次に示す割り当てモードを返し，失敗 

した場合は負の値を返す。 

• 0 x 40 割り当てが存在しない 

• 0 x 50 仮想ドライブの割り当て 

• 0 x 60 仮想ディレクトリの割り当て 

_ dos _ makeassign 関数と _ dos _ rassign 関数は，失敗した場合に負の値を返す 0 

互換性—— Human 68 k ver .3 では DOS コールの番号が変更 （+0 x 30) されたことに注意す 
ること。 

規 格- XC 
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dos breaitck 


用 途—ブレークチヱックを設定する。 

僅 式- #mclude < sys/dos . h > 

11 it _ dos_breakck (int flag ); 

解 説- _ dos_breakck 関数はブレークチヱックの設定を行う。 

flag に設定可能な値は次のとおり。 

• 0 特定のファンクシヨンコールでのみチェックする 

• 1 すべてのファンクシヨンコールでチェックする 

• 2 すべてのファンクシヨンコールでチェッ ク しない 

•-1 設定状況の通知要求 

ブレークチェックを 行う特定の ファンクシヨン コールと その 関数は次のとおり。 



• $ FF 01 

_ dos—getchar 関数 

• $ FF 02 

_ dos_putchar 関数 

• $ FF 03 

_ dos_cominp 関数 

• $ FF 04 

_ dos_comout 関数 

• $ FF 05 

_ dos_prnout 関数 

• $ FF 08 

_ dos_getc 関数 

• $ FF 09 

_ dos.print 関数 

• $ FF 0 A 

_ dos_gets 関数 

• $ FF 0 B 

_ dos_keysns 関数 

• $ FF 0 C 

_ dos_kf lush 関数 

• $ FF 1 D 

_ dos_fputc 関数 

• $ FF 1 E 

_ dos_fput 関数 


_ dos _ breakck 関数は DOS コール 0 xFF 33 を発行することによって处理される。 

戻り値——ブレークチヱックの設定状況を返す。戻り値は，介ぼに指定できる〇〜2の値の 
いずれかになる。 


規 格 — XC 


関連項目- _ dos _ cominp ，_ dos _ comout , _ dos _ fput , _ dos _ fputc , _ dos _ getc ，_ dos _ getchar , 

_ dos _ gets ， _ dos _ keysns ， _ dos_kf lush , _dos . print , _ dos _ prnout , 

_do s—put char 
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dos_chanqe_pr 


用 途ーバックグラウンドプロセスの実行権を放棄する。 

書 式 - #include < sys/dos . h > 

void _ dos _ change_pr ( void ); 

解 説—— _ d OS _ cliang e _pr 関数はバックグラウンドプロセスの実行権を放棄する。その結 
果，現在のタスクは中断し，次のタスクへの切り替えが行われる。 

_ dos _ change_pr 関数は DOS コール OxFFFF を発行することによって処理される 0 
戻り値——なし。 

規 格- XC 

関連項目- _ dos _ get _ pr , _ dos _ kill _ pr , _ dos _ open _ pr , _ dos _ send _ pr , _ dos _ sleep _ pr , 

_ dos _ suspend _ pr , _ dos _ time_pr 
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doschdir 


用 途——カレントディレクトリを変更する。 

僅 式- #mclude < sys/aos . h > 

int _ dos_cMir (const char * file ); 

解 説—— - dos-chdir 関数は如で指定したディレクトリに，カレントディレクトリを変更 

する。 

_ dos_chdir 関数は DOS コール 0 xFF 3 B を発行することによって処理される。 

戻り値——成功した場合は〇を含む正の値を返し，失敗した場合は負の値を返す。通常は〇 
が返るが，特殊デバイスドライバが対象の場合は0以外の正の値の場合もある。 

規 格 — XC 

関連項目- _ dosjnkdir , _ dos_rmdir 
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doschadrv 


用 途——カレントドライブを変更する。 

書 式- # include < sys/dos . h > 

void _ dos_chgdrv (mt drive ); 

解 説—— _ d 0 S _ chgdrv 関数はゴ rz •把で指定したドライブにカレントドライブを変更する。 

み/ vd こはドライブ A : ならば0，ドライブ B : ならば1，ドライブ C : ならば2,以下 
この順番でドライブ Z :まで設定できる。 

_ dos _ chgdrv 関数は DOS コール OxFFOE を発行することによって処理される。 

戻り値——み/把として指定可能な最大ドライブ番号を返す。ただし，み/呢よりも小さな値 
が返った場合はエラーになる。 

規 格 — XC 


404 





Chapter 2 — DOS コールライブラリ 


—dos—chmod 


用 途——ファイル属性を変更する。 

書式- #mclude < svs/dos . h > 

dosmode_t _ dos_chmod (const char * file,int atr ); 

解 説- _ dos_chmod 関数は # で指定したファイルのファイル属性をが/*に変更する。 

0かに指定できる値は次のとおり。ただし，ビット3〜4は互いに排他である。 


•ビット0 

読み込み専用 

•ビット1 

隠しファイル 

• ビット2 

システムファイル 

• ビット3 

ボリュームラべル 

• ビット4 

ディレクトリ 

• ビット5 

通常のファイル 



_ dos_chmod 関数は DOS コール 0 xFF 43 を発行することによって処理される 0 

戻り値——成功した場合は〇を含む正の値を返し，失敗した場合は負の値を返す。通常は〇 
が返るが，特殊デバイスドライバが対象の場合は〇以外の正の値の場合もある。 

規 格 — XC 
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dos cinsns 


用 途- RS -232 C からの入力が可能かとうかを調べる。 

書 式-# include < sys/dos . h > 

int _ dos_cinsns ( void ); 

解 説—— _ dos_cinsns 関数は，現在 RS - 232 C からの入力が可能であるかどうかを調べる 0 
_dos _cinsns 関数は DOS コール 0 xFF 12 を発行することによって処理される〇 

戻り値- RS -232 C からの入力が可能ならば0以外を返し，不可能ならば〇を返す。 

規 格 — XC 
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dosclose 


用 途—ファイルをクロー ズする。 

書式- #include < sys/dos . h > 

int _ dos_close (mt f ildes ); 

解 説一 . dos . close 関数はガゴ打で指定したファイルをクローズする。 

_ dos _ close 関数は DOS コール 0 xFF 3 E を発行することによって処理される。 

戻り値一成功した場合は0を含む正の値を返し，失敗した場合は負の値を返す。通常は0 
が返るが，特殊デバイスドライバが対象の場合は0以外の正の値の場合もある。 

規 格 — XC 
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dos—cominp 


用 途- RS-232C から 1 文字入力する。 

書 式 - # include く sys/dos.h> 

int _dos_cominp (void); 

解 説一 _dos_cominp 関数は RS-232C から 1 文字読み込む 0 このときブレークチェックが 
行われる。 

_dos_cominp 関数は DOS コール 0xFF03 を発行することによつて処理される。 
戻り値—— RS-232C から読み込まれた文字の文字コードを返す。 

注 意——ブレークチェックで 検査され る文字は CTRL+C (ブレーク） のみである。 

規 格 — XC 


関連項目 - _dos_cinsns, _dos_comout 
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dos—common 


用 途- Human68k の common 領域を操作する。 

書 式 - #include <sys/dos .h> 

mt _dos_common_ck (const char *name ノ； 
int _dos_common_del (const char *name); 
int _dos_common_fre (const char *name, int pos, 
int id—psp, int len); 

int _dos_common_lk (const char *name, int pos, 
int id_psp, int len); 

int _dos_common_rd (const char *name, int pos, 
char *buf±, int len); 

int _dos_common_wt (const char *name, int pos, 
const char *buff, int len); 



解 説- _dos_common_ck 関数は， Human68k の common 領域においてで指定した 

ブロックが存在するかどうかを調べる。 . 

_ dos _ common_del 関数は， Human 68 k の common 領域においてで指定し 
たブロックを削除する。 

_ dos _ common_fre 関数は， Human 68 k の common 領域においてで指定し 
たブロック内の pos で指定したデータのロックを解除する。ロックを解除すると， 
切で指定したプロセス以外のプロセスからもデータをアクセスできるように 
なる。はブロック名， pos はブロック内のデータの位置， id—psp はロックし 
たと きにつけたプロセス ID, /⑼はロックしたときに指定したバイト数を意味す 
る。 _ dos _ common_fre 関数で指定する引数は， - dos _ common_lk 関数で指疋した引 
数と完全に同じでなくてはならない。これは，ロックしたプロセス以外がロック 
解除を行うのを防ぐためである。 

_dos_common_lk 関数は， Human68k の common 領域において⑽撕で指定した 
ブロック内のさらに/で指定したデータをロックする。ロックすると， id-psp で 
指定したプロセス以外のプロセスからはデータをアクセスできなくなる 。 name 
はブロック名， pos はブロック内のデータの位置， icLpsp はロックするプロセスの 
プロセス ID， た/2はロックするバイト数を意味する。/ゴ -/W/7 には必ず自プロセス 
のプロセス ID を指定すること。もしも適当に/ゴを指定すると，自分自身で 
もロックを解除できなくなる可能性があるからである。また，ロック解除は自分 
自身以外のプロセスからは不可能なので，ロックした場合は必ずロックを解除す 
ること。ロックを解除せずにプロセスを終了した場合，永久にロック解除ができ 
なくなる。 
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_ dos _ common_rd 関数は， Human 68 k の common 領域において似/狀で指定した 
ブロックのさらに/ 7 oy で指定したバイト位置から， Ien バイ ト分わ w ガで指定する 
領域へ読み込む。 

_ dos _ common_wt 関数は， Human 68 k の common 領域において name で指定した 
ブロックのさらに/ 7 oy で指定したバイト位置から， len バイ ト分 Zm ガで指定する 
領域のデータを書き出す。に0を指定するとブロックを切り詰める。 

これらの関数は DOS コール 0 xFF 55(0 xFF 85) を発行することによって处理さ 
れる。 


戻り値- _ dos _ common _ ck 関数は， / zame で指定したブロックが存在する場合はそのブロッ 

クの大きさを返し，存在しない場合は負の値を返す。 

一 dos _ common _ rd 関数は，成功した場合は読み出したバイト数を返し，失敗した場 
合は負の値を返す。 

一 d OS _ CO mmcm _ wt 関数は，成功した場合は書き出したバイト数を返し，失敗した場 
合は負の値を返す。 

これ以外の関数では，失敗した場合は負の値を返す。 

互換性—— Human 68 k ver .3 では DOS コールの番号が変更 （+0 x 30) されたことに注意す 
ること。 

規 格- XC 
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doscomout 


用 途—— RS -232 C へ1文字出力する。 

書 式- #include < sys/dos . h > 

void _ dos_comout (int code ); . 

解 説—— _ dos.comout 関数は〇?みで指定した 1 文字を RS -232 C へ出力する 0 このときブ 

レークチェックが行われる。 

_ dos_comout 関数は DOS コール 0 xFF 04 を発行することによって処理される 0 
戻り値-なし。 

注 意——ブレークチェックで検査される文字は CTRL+C (ブレーク）のみである。 

規 格 —— XC 

関連項目- - dos ^ cominp , _ dos_coutsns 
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dosconctrl 


用 途 一 CON デバイスの出力を直接制御する。 

書式-# include < sys/dos . h > 

void _ dos _ c_putc (int code ;; 

int _ dos _ c_print (const char ^ message ); 

int _ dos _ c_color (int atr ); 

int _ dos _ c_locate (int x , int y ); 

int _ dos _ c _ down_s ( void ); 

int _ dos _ c _ up_s ( void ); 

int _ dos _ c_down (int cnt ); 

int _ dos _ c_up (int cnt ); 

int _ dos _ c_right (int cnt ); 

int _ dos _ c_left (int cnt ); 

int _ dos _ c _ cls_ed ( void ); 

int _ dos _ c _ cls_st ( void ); 

int _ dos _ c _ cls_al ( void ); 

int _ dos _ c _ era_ed ( void ); 

int _ dos _ c _ era_st ( void ); 

int _ dos _ c _ era_al ( void ); 

int _ dos _ c_ins (int cnt ); 

int _ dos _ c_del (int cnt ); 

int _ dos _ c_fnkmod (int mode ); 

int _ dos _ c_window (int ys , int yl ); 

int _ dos _ c_width (int mode ); 

int _ dos _ c_curon ( void ); 

int _ dos _ c_curoff ( void ); 

解 説- - dos _ c_putc 関数は⑺みで指定した 1 バイトのデータを表示する。 

_ dos _ c_print 関数は供で指定した文字列を表示する。 

- dos — c—color 関数は 0 かで指定した属性を設定する。設定可能なカラー属性は次 
のとおり。 

• 〇 黒 

• 1 水色 

• 2 黄色 

• 3 白 

•4 黒 
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• 5 水色の強調 

• 6 黄色の強調 

• 7 白の強調 

• 8 黒 

•9 水色のリバース 
•10 黄色のリバース 
•11 白のリバース 
• 12 黒 

•13 水色の強調， リバース 
• 14 黄色の強調， リバ ー ス 
•15 白の強調， リバース 

_ dos _ c_locate 関数はズおよび少で指定した位置へ力ーソルを設定する。 

_ dos _ c _ down_s 関数は カーソル 位置を1行下へ移動する。 このとき， 最終行より 
下に移動する場合はスクロールアップする。 

_ dos _ c _ up_s 関数は カーソル 位置を1行上へ移動する。このと き， 先頭行より上 
に移動する場合は スクロール ダウンする。 

_ dos _ c_down 関数は カーソル 位置をご价行 下へ 移動する。このと き， 最終行より 
下に移動しようとした場合でも スクロール アップは行われない。また ， c がに 0を 
指定した場合は1を t 旨定したと解釈される。 

_ dos_ C ュ ip 関数はカーソル位置を行上へ移動する。このとき，先頭行より上 
に移動しようとした場合でもスクロールダウンは行われない。また，に0を 
指定した場合は1を指定したと解釈される。 

_ dos _ c_xight 関数は カーソル 位置を OU 桁右へ移動する。このとき，再右端行よ 
り右に移動しようとした場合でも左スクロールは行われない。また ， c がに 0を 
指定した場合は1を指定したと解釈される。 

_ dos_c ユ eft 関数は カーソル 位置を桁左へ移動する。このとき，再左端行よ 
り左に移動しようとした場合でも右スクロールは行われない。また， ⑺“こ 0を 
指定した場合は1を指*定したと解釈される。 

_ dos _ c _ cls_ed 関数は，現在のカーソル位置から最終行右端までのテキスト画面 
をクリアする。 

_ dos _ c _ cls_st 関数は，先頭行左端から現在のカーソル位置までのテキスト画面 
をクリアする。 

_ dos _ c _ cl S _al 関数はテキスト画面全体をクリアする。クリア後カーソル位置は 
ホームポジションへ移動する。 

_ dos _ c _ era_ed 関数は，現在のカーソル位置からカーソルがある行の右端までを 
クリアする。 
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_ dos _ c . era _ st 関数は，現在カーソルのある行の左端からカーソル位置までをク 
リアする。 

_ dos _ c _ era _ al 関数は，現在カー ソルの ある行をクリアする 0 

_ d 0 S _ C _ in S 関数は，現在 カーソルの ある行の下に672/ で 指定した行数の空白行を 
挿入する。また， c がに0を指定した場合は1を指定したと解釈される。 

_ dos _ C _ del 関数は，現在 カーソルの ある行から c がで 指定した行数削除する。ま 
cnt に0を指定した場合は1を指定したと解釈される。 

_ dos _ c _ fnkmod 関数は，ファンク ショ ンキー行を mo みで指定したモードに設定 
する。ただし，この指定を行うと スクロール 範囲の設定がクリアされる 。 mode 
には次の値を設定することができる。 


• 0 ファンクシヨンキー表示 （スクロール 範囲は0から31行） 

• 1 シフトファンクシヨン キー 表示 （スクロール 範囲は0から31行) 

• 2 何も表示しない（スクロール範囲は0から31行） 

• 3 通常の行とする（スクロール範囲は0から32行） 

•-1現在の設定モードを返す 


一 dos _ c _ window 関数はスクロール範囲を設定する。このとき力ーソルはホームポ 
ジションへ移動する。また， 少と少 /を足した値はファンクションキー行のモード 
が3のときに32まで，それ以外のときは31までとなるように設定しなくてはな 
らない。スクロール範囲の設定を行うと，絶対座標 （0, ys ) が論理座標 (0, 0) 
となる。 

_ dos _ c _ width 関数は画面モードの設定を行う。 wo みには次の値を設定すること 
ができる。 


0 

1 

2 

3 

4 

5 

-1 


高解像度768 X 512 
高解像度768 X 512 
高解像度512 X 512 
高解像度512 X 512 
高解像度512 X 512 
高解像度512 X 512 
現在のモードを返す 


グラフィックなし 
グラフィック16色 
グラフィックなし 
グラフィック16色 
グラフィック256色 
グラフィック65536色 


_ dos _ c _ curon 関数はカーソルを表示状態にする。 

_ dos _ c _ curoff 関数はカーソルを非表示状態にする。 

なお，これらの機能は CON デバイスによってサポートされている機能である。 
これらの関数は DOS コール 0 xFF 23 を発行することによって処理される。 
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戻り値—— _ d 0 S _ C _ width 関数は設定変更前の画面モードを返す。 

それ以外の関数は，正常終了した場合は0を返す。 

規 格 —— XC 
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-dosconsns 


用 途——画面への出力が可能かどうかを調べる。 

書式- #mclude < sys/aos . h > 

int _ dos_consns 、 void ); 

解 説—— — dos — consns 関数は，現在画面への出力が可能であるかどうかを調べる。 

_ dos _ consns 関数は DOS コール OxFFlO を発行することによって処理される。 

戻り値一画面への出力が可能ならば0以外を返し，不可能ならば0を返す。 

規 格 — XC 
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doscoutsns 


用 途—— RS -232 C への出力が可能かどうかを調べる。 

書 式- #include < svs/dos . h > 

mt _ dos_coutsns ( void ); 

解 説- _ dos_coutsns 関数は，現在 RS -232 C への出力が可能であるかどうかを調べる 0 

_ dos_coutsns 関数は DOS コール 0 xFF 13 を発行することによって処理される 0 

戻り値—— RS -232 C への出力が可能ならば0以外を返し，不可能ならば0を返す。 

規 格 — XC 
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_dos create 


用 途—ファイルを新規に作成する。 

書式 - #mclude <sys/dos .h> 

int _dos_create (const char *file, dosmode_t atr); 

解 説- _dos_create 関数はで指定したファイルを atr のファイ ル属性で新規に作成す 

る。すでに存在している場合でもエラーとならず，強制的に作成する。 

a/r に指定できる値は次のとおり。ただし，ビット3〜4は互いに排他である。 


•ビット 0 

読み込み専用 

•ビット 1 

隠しファイル 

•ビッ t 

、 2 

システムファイル 

•ビッ f 

、 3 

ボリュームラベル 

籲ビツ \ 

、 4 

ディレクトリ 

• ビット 5 

通常のファイル 


_dos_create 関数は DOS コール 0xFF3C を発行することによって処理される。 
戻り値——成功した場合は作成したファイルハンドルを返し，失敗した場合は負の値を返す。 
規 格- XC 
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dos—ctlabort 


用 途- CTRL + C アボート处理へジャンプする。 

書 式- #include < sys/dos . h > 

void __volatile _ dos_ctlabort ( void ); 

解 説一 _ dos _ ctlabort 関数は， CTRL+C (ブレーク）が押された場合の処理へ実行を移す 
ことができる。 

_ dos _ ctlabort 関数は DOS コール OxFFFl を発行することによって処理される。 
戻り値一なし。 

規 格- Project LIBC Group 
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—dos—curair 


用 途——カレントディレクトリを取得する。 

書 式- #include < sys/dos . h > 

int _ dos_curdir (int drive , const char * buff ); 

解 説一 _ do S _ curdir 関数は，め vVe で指定したドライブのカレントディレクトリを buff 
へセットする。み/ ve にはカレントドライブならば0，ドライブ A : ならば1，ドラ 
イブ B :ならば2，以下この順番でドライブ Z :まで設定できる。 

ゐにはドライブ名は含まれず，また先頭のパス区切り記号は省かれる。たとえば， 
カレントディレクトリが “/ DIR / SUBDIR ” だった場合， buff には “ DIR / SUBDIR ” と 
設定される。 

一 dos - curdii •関数は DOS コール 0 xFF 47 を発行することによって処理される。 
戻り値——成功した場合は0を含む正の値を返し，失敗した場合は負の値を返す。 

規 格 — XC 
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—doscurdrv 


用 途—カレントドライブの番号を調べる。 

•rf 式- #mclude < sys/aos . h > 

mt _ dos_curdrv ^ void ); 

解 説—— _ d OS _ C m : drv 関数はカレントドライブのドライブ番号を返す。 

_ dos _ curdrv 関数は DOS コール 0 xFF 19 を発行することによつて处:理される。 

戻り値——カレントドライブのドライブ番号を返す。ドライブ番号は A : ドライブを0とした 
番号である。 

規 格 — XC 
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dos delete 


用 途——ファイルを削除する。 

書 式- # include < sys/dos . h > 

int _ dos_delete ^const char * flie ;; 

解 説—— - dos - delete 関数は片で指定したファイルを削除する。 

力 fc にはワイルドカードやディレクトリは指定できない。また，オープンされて 
いるファイルを削除しようとした場合はエラーとなる。 

_ d 0 s _ delete 関数は DOS コール 0 xFF 41 を発行することによつて処理される。 

戻り値——成功した場合は0を含む正の値を返し，失敗した場合は負の値を返す。通常は0 
が返るが，特殊デバイスドライバが対象の場合は0以外の正の値の場合もある。 

規 格 — XC 


422 






Chapter 2—DOS コールライブラリ 


dos diskred 


用 途—ブロックデバイスへの直接入力を行う。 

# it - # inc 丄 ude < sys/dos . n > 

void _ dos_diskred (void * addr , 

int drive , int sector , int seclen ); 
void _ dos _ diskred 2 (void * addr , 

int drive , int sector , int seclen ); 

解 説- _ dos_diskred 関数はブロックデバイスの直接入力を行う。 

読み込みはセクタ単位で行われるので，如ルからのバッファのサイズは，読み 
込みを行うデバイスの1セクタのサイズの整数倍となるように設定する。なお標 
準のデバイスドライバでは，1セクタは1024バイトなので1024の倍数を指定す 
る。み fve には，カレントドライブならば0，ドライブ A : ならば1,ドライブかな 
らば2,以下この順番でドライブ Z : まで設定できる。 

仮想ドライブや仮想ディレクトリに割り当てた実ドライブにはアクセスできない。 

货 c 如/*および seclen は 65536までの数値で指定すること。これ以上のセクタ数/ 
セクタ長を指定することはできない。これ以上の大容量ドライブに対するアクセ 
スを行う場合は， _ dos _ diskred 2 関数を使用すること。 

_ dos _ diskred 2 関数は大容量ブロックデバイスに対しての直接入力を行う。 



_ dos _ diskred 2 関数に対しては，從 c * 如/*および seclen に対して65536を越えたロン 
グワードの値を指定することができる。これ以外の引数に関しては， _ dos_diskred 
関数と同じである。 

これらの関数は DOS コール 0 xFFF 3 を発行することによって処理される。 

戻り値——なし。 

規 格 — XC 

関連項目- _ dos _ diskwrt , _ dos _ diskwrt 2 
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dos aisKwri 


用 途ーブロック デバイ スへの直接出力を行う。 

書 式- #include く sys / dos . h > 

void _ dos_diskwrt (voia * addr , 

int drive , int sector , int seclen ); 
void _ dos _ diskwrt 2 (voia ホ addr , 

int drive , int sector , int seclen ); 

解 説- _ dos _ diskwrt 関数はブロックデバイスの直接出力を行う。 

書き込みはセクタ単位で行なわれるので，ふかからの バッファの サイズは，書き 
込みを行うデイスの1セクタのサイズの整数倍となるように設定する。なお標 
準のデバイスドライバでは1セクタは1024バイトなので1024の倍数を指定す 
る。み/ vd こは，カレントドライブならば〇,ドライブ A : ならば1，ドライブ B : な 
らば2,以下この順番でドライブ Z : まで設定できる。 

仮想ドライブや仮想ディレクトリに割り当てた実ドライブにはアクセスできない。 

sector および seclen には 65536までの数値で指定すること。これ以上のセクタ数/ 
セクタ長を指定することはできない。これ以上の大容量ドライブに対するアクセ 
スを行う場合は- dos _ diskwrt 2 関数を使用すること。 

_ dos _ diskwrt 2 閨数は大容量ブロックデバイスに対しての直接出力を行う。 

_ dos _ diskwrt 2 関数に対しては從ご如/*および seclen に対して65536を越えたロン 
グワードの値を指定することができる。これ以外の引数に関しては - dos-diskwrt 
関数と同じである。 

これらの関数は DOS コール 0 xFFF 4 を発行することによって処理される。 

戻り値——なし。 

規 格 — XC 

関連項目- _ dos _ diskred , _ dos _ diskred 2 


424 






Chapter 2 — DOS コールライブラリ 


_dos_drvctrl 


用 途 ——ドライブ状態のチェックおよび設定を行う。 

谱工 C - # mc 丄 ude < sys/dos . h > 

void _ dos_drvctrl (int mode , int drive ); 

解 説- - dos . drvctrl 関数は，み/敗で指定したドライブの状態センスまたは設定を行う。 

ゴ/7•阳にはカレントドライブならば0,ドライブ A : ならば1,ドライブ B : ならば 
2，以下この順番でドライブ Z : まで設定できる。 wo みの設定値は次のとおり。 

•0 ドライブ状態のセンス 

•1 イジェクトする。ただし該当ドライブにオーブンファイルが存在 

する場合はイジェクトしない 

• 2 イジヱクトを禁止する （ mode = l の指定より優先） 

• 3 イジヱクトを許可する。ただし該当ドライブにオープンファイル 

が存在する場合は，クローズはされないが自動的にバッファフ 
ラッシュされる 

• 4 ディスクがセットされていないときに LED を点滅 

• 5 ディスクがセットされていないときに LED を消灯 

• 6〜8 使用不可 

• 9 該当ドライブのカレントディレクトリをルートディレクトリと 

し， FAT 検索も先頭からにする。ただし，オープンファイルが 
存在する場合はエラーとなる 

• 10 該当ドライブの FAT 検索を先頭からにする 

_ dos _ drvctrl 関数は DOS コール OxFFOF を発行することによつて处理される。 

戻り値 ——み/把で指定したドライブの状態をビットフィールドで返す。各ビットの内容は次 
のとおり。 


•ビッ 

卜 0 

メディア誤挿入 

•ビッ 

卜 1 

メディア揷入 

•ビッ 

卜 2 

ノツトレデイ 

•ビッ 

卜 3 

ライトプロテクト 

•ビッ 

卜 4 

ユーザに よるイジ ェク ト禁止 

•ビッ 

卜 5 

バッファ あり 

•ビッ 

卜 6 

イジュクト禁止 

•ビツ 

h 7 

LED 点滅 



いずれも該当ビットが1のとき，上記の状態となる。 
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第2部 


またビット2, 3については， mode に0 ( ドライブ状態のセンス）を指定し，かつ 
メディアが挿入されている場合にのみ有効となる。 

規 格- XC 
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dosdrvxchg 


用 途—ドライブを入れ替える。 

書 式 - #include < sys/dos . h > 

void _ dos_drvxchg (int old , int new ); 

解 説一 - dos_drvxchg 関数は old と で指定したドライブを入れ替える。 old ヒ に 

は，カレントドライブならば〇，ドライブ A : ならば1,ドライブ B : ならば2,以 
下この順番でドライブ Z : まで設定できる。 

_ dos_drvxchg 関数は DOS コール 0 xFF 34 を発行することによって処理される。 
戻り値一なし。 

規 格一 XC 
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dosdskfre 


用 途——ディスクの残り容量を調べる。 


式^— " ttinc 丄 ude < sys / dos . n > 

int _ dos_dskfre unt drive , struct _freeinf * buff ); 


解 説一 _ do S _ dskf re 関数はみ/阳で指定したドライブの残り容量を調べ，その結果を buff 

で指定した- freeinf 構造体へセットする。ガに指定する- freeinf 構造体は次 
のとおり。 


struct _ireeinf t 

unsigned short free; /* 使用可能なクラスタ数 */ 
unsigned short max; /* 総クラスタ数 */ 
unsigned short sec; /*1 クラスタ当たりのセクタ数 */ 
unsigned short byte; /*1 セクタ当たりのバイト数 */ 

>； 


_ dos_dskfre 関数は DOS コール 0 xFF 36 を発行することによって処理される。 


戻り値一成功した場合は使用可能なバイト数（最大 2 G バイト）を返し，失敗した場合は負 
の値を返す。 


規 格- XC 
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—dosdup 


用 途—ファイルハンドルを複写する。 

書式- #mclude < sys/aos . h > 

int _ dos_dup (mt 11 丄 des ); 

解 説—— _ dos_dup 関数は fildes で指定 したファイルハンドルを複写して，新しいファイル 

ハンドルを作成する。 

複写されたファイルハンドルは複写元のファイルハンドルと同一のファイルに対 
してアクセスするので，どちらのファイルハンドルを使用しても，同じファイル 
に対してファイル操作が可能となる。 

_ d OS _dup 関数は標準入力/標準出力を切り替える（リダイレクトなど）ときに，切 
り替え前のファイルハンドルを保存する場合などに使用する。 

_ dos_dup 関数は DOS コール 0 xFF 45 を発行することによって処理される。 

戻り値——成功した場合は複写された新しいファイルハンドルを返し，失敗した場合は負の 
値を返す。 

規 格 — XC 

関連項目- _ dos _ dupO , _ dos _ dup 2 
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dos dupO 


用 途—ファイルハンドルを強制的に複写する。 

書 式- # include < sys/dos . h > 

int _ dos_dupO (int fildes , int newdes ); 

解 説—— _ dos _ dupO 関数は fildes の ファィルハン ドルを， newdes のフ了イルハン ドルへ強 
制複写する。 

_ dos _ dupO 関数は， Human 68 k がデフォルトでオープンしている〇〜4までの 
ファイル ハンドルの 切り替えを 行う （ CTTY ) ためのものである。標準入出力/標準 
エラー出力を- dos _ dup 関数や- dos _ dup 2 関数によって切り替えた（リダイレクト 
など）後で- dos—close _数を実行させると， _ dos _ dupO 関数で切り替えたファイ 
ルハンドルへ 戻される。 

_ dos _ dupO 関数は DOS コール 0 xFF 2 F を発行することによって処理される。 

戻り値——成功した場合は/7^；ゴ打の前の値を返し，失敗した場合は負の値を返す。 

規 格 — XC 

関埋項目- _ dos - close ，_ dos _ dup , _ dos _ dup 2 


430 





Chapter 2—DOS コールライブラリ 


—dos—dup2 


用 途ーファイルハンドルを複写する。 

書式 - #mclude <svs/dos .h> 

int _dos_dup2 unt fildes, mt newdes); 

解 説—— _dos_dup2 関数はガゴがで指定したファイルハンドルを，也 S のファイルハン 

ドルに強制複写する。ただし，ゴ打で指定したファイルハンドルがオープンさ 
れている場合は，クローズしてから複写する。 

複写されたファイルハンドルは複写元のファイルハンドルと同一のファイルに対 
してアクセスするので，どちらのファイルハンドルを使用しても，同じファイル 
に対してファイル操作が可能となる。 

一 d OS _dup2 関数は標準入力/標準出力を切り替える（リダイレクトなど）ときに， 
切り替え前のファイルハンドルを保存する場合などに使用する。 

_dos_dnp2 関数は DOS コール 0xFF46 を発行することによって処理される。 
戻り値一失敗した場合は負の値を返す。 

規 格 —— XC 

関連項目 - _dos_dup, _dos_dupO 
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dos—errabort 


用 途—— エラー アボート処理へジャンプする0 

書 式-# include < sys/dos . h > 

void __volatile __ dos_errabort ( void ); 

解 説- _ dos_errabort 関数は，エラーによってプロセスをアボートする場合の处理へ実 

行を移すことができる。 

_ dos—errabort 関数は DOS コール 0 xFFF 2 を発行することによって处理される 0 
戻り値——なし。 

規 格- Project LIBC Group 
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dosexec 


用 途^—プログラムをロード/実行する。 

書式- #mclude < svs/dos . h > 

mt _ dos _ loadexec 、 const char * nle , 

const struct _comline * comline , 
const char * envptr ); 

int _ dos_load (const char * nle , const struct _comline * comline , 
const char * envptr ); 
int _ dos_pathchk (const char * file , 

const struct _comline * comline , 
const char * envptr ); 

int _ dos_loadonly (const char * file , const void * loadaddr , 
const void * limitaddr ); 
int _ dos_execon 丄 y (void * jmpaddr ); 

int _ dos_bindno (const char * fllel,const char * file 2); 
int _ dos _ exec 2 (int mode , const char * file , const char * pl , 
const char * p 2); 

解 説—— - dos-loadexec 関数は⑺ m/zVie で指定したコマンドラインと⑼ v〆 / •で指定した環 

境 に基づいて， file で指定したプログラムをロード/実行する。 

⑼ V /7 かに0を指定すると，呼び出しプロセスの環境がそのまま引き継がれる。 

声かの最上位8ビットの意味は次のとおり。 

• 0 拡張子 . R /. Z /. X にしたがいロー ドする 

• 1 R 形式のファイルとしてロードする 

• 2 Z 形式のファイルとしてロー ドする 

• 3 X 形式のファイルとしてロー ドする 

comline に指定する .comline 構造体は次のとおり。 

struct _comline { 

unsigned char len; /* コマンドラインの長さ */ 
char buffer [255] ; /* コマンドライン文字列 */ 

>； 

_ dos_load 関数は comline で指定したコマンドラインと⑽ v /7 ひで指定した環境に 
基づいて，处で指定したプログラムをロードする。 

envptr に0を指定すると，呼び出しプロセスの環境がそのまま引き継がれる。 
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# の最上位 8 ビットの意味は- dos _ loadexec 関数と同じである 0 

_ dos _ pathchk 関数は⑼ vp びで指定した環境から環境変数 path をサーチし，その 
環境変数 path で指定したパスから file をサーチし， file のコマンド行をファイル名 
(ドライブ名，バス名つき）とコマンドラインに分けて， それぞれ filet comline 
が示す領域にセットする。 

如には90バイト以上， combine には 1 2洸バイ ト以上の領域が必要となる 。 envptr 
に0を指定すると，呼び出しプロセスの環境をサーチする。この閨数を実行後， 
comline t file を指定して— dos — loadexec 関数，または- dos _ load 関数を実行した 
場合，すでに通ったバスであれば，どのパスにおいても簡単にプログラムを実行 
することができる。 

⑼ v /7 ひに指定する環境へのボインタはグローバル変数 environ が指定する C 独 
自の環境ではなく， Human 68 k の管理する環境へのボインタでなくてはならな 
い。そのため⑼ v /?/ r に0以外を指定する場合は注意が必要である。 

_ dos _ loadonly 関数は loadaddr から limitaddf •ま でのメモリに，如で指定した 
プログラムをロー ドする。 

file の最上位8ビッ トの意味は- dos _ loadexec 関数と同じである。 

_ dos _ execonly 関数は- dos _ load 関数でロードしたプログラムを実行する。 
には- dos - load 関数の戻り値を指定する。 

_ dos _ bindno 関数は你7で指定したバインドファイルに含まれる如2で指定し 
たモジュールのモジュール番号を取得する。 

オーバーレイ X ファィルに含まれる個々のファイルを実行するためには，各ファイ 
ルに割りあてられたモジュール番号を指定しなくてはならないので， _ dos_bindno 
関数でモジュール番号を求める。 

_ dos _ exec 2 関数はプログラムのロード，実行，モジュール番号の取得を行う。 
mode に指定する値は次のとおり。 

•ビット15 〜 8 モジ ュール番号 
•ビット7〜〇 モード番号 

mode に指定できる値とその内容および/?7， p 2 との 関係を次に示す。 

• 0 で指定したコマンドラインとで指定した環境ボインタを用いて， 

如で指定したファイルをロード，実行する。の環境ポインタを0と 
すると，現在の環境を引き継ぐ 

•1 で指定したコマンドラインと，で指定した環境ポインタを用いて， 

如で指定したファイルをロードする。の環境ポインタを0とすると， 
現在の環境を引き継ぐ 

• 2 で指定した環境より環境変数 path を検索し，それを基に命で指定 

した コマン ド行 （コマン ド名+オフ。 シヨンなど） を コマン ド名のパスと コ 
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マンドラインに分離し，それぞれ filet 〆 の指定する領域へセットす 
る。/^の環境ポインタを0とすると，現在の環境を引き継ぐ。 
mode を2ヒ して- dos _ exec 2 関数を実行した後に， mode を Q または1 
として- d 0 S _ ex ec 2 関数を実行すれば，環境変数 P atM こ設定されている 
ディレクトリにあるコマンドを簡単に実行できる。 

• 3 にロードアドレス，尸2にリミットアドレスを J 旨定して，如で手旨定し 

たプログラムをロー ドする 

• 4 处に実行アドレスを指定し，すでにロードされているプログラムを実 

行する。この場合， mode のモジュ ール番号は0とする 

• 5 力で指定したオーバーレイファイルより，/?/で指定したモジュールを 

検索し，見つかった場合にそのモジュール番号を返す。この場合， mode 
のモジユール番号は0とする 



mode が1，2, 3のとき，如の最上位8ビットの意味は- dos ユ oadexec 関数と 
同じである。 

これらの関数は DOS コール 0 xFF 4 B を発行することによって処理される。 


戻り値一 - dos — loadexec 関数は，成功した場合は実行したプロセスの終了コードを返し, 
失敗した場合は負の値を返す。 

_ do S _ load 関数は，成功した場合は口ードしたプログラムのアドレスを返し，失 
敗した場合は負の値を返す。 

_ do S _ patli C hk 関数は，失敗した場合は負の値を返す。 

_ d OS _ load 011 ly 関数は，成功した場合はロードしたプログラムのサイズを返し, 
失敗した場合は負の値を返す。 

_ dos _ execonly 関数は，成功した場合は実行したプロセスの終了コードを返し， 
失敗した場合は負の値を返す。 

_ dos _ bindno 関数は，成功した場合は作2のモジュール番号を戻り値のビット15 
〜8に返し，失敗した場合は負の値を返す。 

_ dos _ exec 2 関数は成功した場合， mode が0, 4ならば子プロセスの終了コード 
を，1ならばロードしたプログラムの実行アドレスを返す。戻り値が負の値なら 
ば エラーか•起こったこ とを示し， ロー ドや実行は行われない。 

支すこ mode が2, 3ならば失敗した場合に負の値を返し，5ならばモジュール番号 
を戻り値のビット15〜8に返す。いずれも失敗した場合は負の値を返す。 

規 格一 XC 


435 






ライブラリー第 2 部 


dosexit 


用 途——現在のプロセスを終了し，親プロセスへ復帰する。 

書 式~-# include < sys/dos . h > 

void ― volatile _ dos_exit ( void ); 

解 説一 _ dos_exit 関数は現在のプロセスを終了し，呼び出した親プロセスへ復帰する。 

このとき，オープンされているファイル（子プロセスがオープンしたファイルも 
含む）をすベて クローズ する。 

_ dos_exit 関数は DOS コール OxFFOO を発行することによって処理される。 

戻り値——親プロセスへは0が返される。 

注 意——親プロセスへはいつでも0が返される。戻り値の指定が必要な場合は， _ dos _ exit 2 

関数を使用すること。 

規 格 — XC 

関連項目一 —_ dos _ exit 2, _ dos_keeppr 
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—dos—exit2 


用 途一現在のプロセスを終了し，親プロセスへ復帰する。 


書 式- #include < sys/dos . h > 

void ― volatile _ dos _ exit 2 ^int code ); 

解 説一 - dos _ exit 2 関数は現在のプロセスを終了し，呼び出した親プロセスへ復帰する。 

ただし，プロセスの終了時には終了コードとして⑺みが親プロセスへ返される。 
このとき，オープンされているファイル（子ブロセスがオープンしたファイルも 
含む）をすベて クローズ する。 

_ dos _ exit 2 関数は DOS コール 0 xFF 4 C を発行することによって処理される。 



戻り値——呼び出したプロセスへは戻らない。親プロセスへは C 0 みが返される。 


規 格 —— XC 


関連項目- _ dos _ exit , _ dos_keeppr 
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dos—fatchk 


用 途——指定ファイルの使用セクタが連続しているかどうかを調べる。 

書 式- # include < sys/dos . h > 

int _ dos_fatchk (const char * file , unsigned short * buff ); 

解 説一 _ dos_f atchk 関数は如で指定したファイルに ついて，その 使用して いる FAT の 

使用状況を^/#へ格納し，如#の使用バイト数を返す。 

つまり戻り値が8 の場合に， file で指定したファイルは連続した FAT を使用して 
いることになる。また，使用セクタ番号を調べることで，ファイルをオープンし 
なくても- dos _ diskred 関数や- dos _ diskred 2 関数を使用して，直接データを取 
得することが可能である。 

_dos _fatchk 関数は DOS コール 0 xFF 17 を発行することによって処理される。 

戻り値——成功した場合は如# の 使用バイト数 （バッファの 終端を示す0を含む）を返し，失 
敗した場合は負の値を返す。なお ， buffit unsigned short 型の配列として使用 
される。設定されるデータは次のとおり。 

• +0ドライブ番号 

• +2 先頭ブロックの先頭セクタ番号 

• +4 ブロックが連続して使用しているセクタ数 

• +6 次ブロックの先頭セクタ番号 

• +8 ブロックが連続して使用しているセクタ数 

• +n 終端を示す0 (unsigned short 型） 

ただし，ブロックの先頭セクタ番号が0の場合にバッファの終端とする。また， 
ドライブ番号は A : ドライブを1とした番号である。 

注 意——大容量メディア上のファイルに対しては， _ dos _ fatchk 2 関数を使用すること。 

_ dos _ fatchk 2 関数は，セクタ番号およびセクタ数を unsigned 10 ng 型で返す。 

規 格— XC 

関埋項目- _ dos _ diskred , _ dos _ diskred 2，_ dos _ fatchk 2 
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—dos—fatchk2 


用 途——指定ファイルの使用セクタが連続しているかどうかを調べる。 

# j-i - #inc 丄 ude < sys/dos . h > 

mt _ dos _ fatchk 2 (const char * file , 

unsigned short * buff , int len ); 

解 説^— _ dos _ fatclik 2 関数は处で指定したファイルについて，その使用している FAT 

の使用状況を^へ格納し，みがの使用バイト数を返す。 

つまり戻り値が14の場合に，你で指定したファイルは連続した FAT を使用し 
ていることになる。 

なお，如#に設定可能な最大バイト数は/⑼で指定する。また，使用セクタ番号を調 
ベることで，ファイルをオープンしなくとも _ dos _ diskred 関数や- dos _ diskred 2 
関数を使用して，直接データを取得することが可能である。 

_ dos _ fatchk 2 関数は DOS コール 0 xFF 17 を発行することによって処理される。 

戻り値——成功した場合はわ Z # の使用バイト数 （バッファの 終端を示す0を含む）を返し，失 
敗した場合は負の値を返す。なお，ゐ W ガは先頭のドライブ番号が unsigned short 
型，それ以降は unsigned long 型の配列として使用される。設定されるデータ 
は次のとおり。 

• +〇 ドライブ番号 

• +2 先頭ブロックの先頭セクタ番号 

• +6 ブロックが連続して使用しているセクタ数 

• +10次ブロックの先頭セクタ番号 

• +14ブロックが連続して使用しているセクタ数 

• +n 終端を示す0 (unsigned short 型） 

ただし，ブロックの先頭セクタ番号が0の場合にバッファの終端とする。また， 
ドライブ番号は A : ドライブを1とした番号である。 

注 意—— _ do S _ fatchk 2 関数は- do S _fatchk 関数に対して，大容量メディアや特殊メディア 

上のファイルに対応している。 

規 格— XC 


関連項目- _ dos _ diskred , _ dos _ diskred 2, _ dos_fatchk 
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_dos fflush 


用 途——ディスクのリセットを行う。 

書 式- # include < sys/dos . h > 

void _ dos_fflush ( void ); 

解 説- _ dos_f flush 関数はディスクのリセットを行う 0 

ディスク バッファの 内容をすべてフラッシュするが，オープンされているファイ 
ルのクローズは 行わない。 

_ dos_f flush 関数は DOS コール OxFFOD を発行することによって処理される。 


戻り 

値- 

-なし。 

規 

格- 

—— XC 
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dos_fgetc 


用 途—ファイルハンドルから1バイト入力する。 

書式- #mclude < sys/dos . h > 

void _ dos_fgetc ^mt fllaes ;; 

解 説—— _ dos_fgetc 関数は fildes で指定したファイルハンドルから入力があるまで侍ち， 
入力された1バイトを返す。 

_ dos_fgetc 関数は DOS コール OxFFIB を発行することによって処理される。 

戻り値-入カコードを返す。 

規 格一 XC 
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_dos—fgets 


用 途——ファイルハンドルから文字列を入力する。 

書 式- #include < sys/dos . h > 

int _ dos_fgets (struct 一 inpptr * inpptr,int fildes ); 

解 説—— _ dos _ fgets 関数はで指定したファイルハンドルから，入カ データ 中に CR/LF 

コード（改行コード）が現れるまで文字列を入力する。入力中はブレークチヱック 
を行わず， VOID / NEWLINE が入力されても改行しない。 

入力された文字列は， fn /?/? びで指定 した- inpptr 構造体のメンバ length およ 
び buffer へ格納される。また，格納される最大入力文字数を- inpptr 構造体の 
メンバ max によって指定する。ただし， max で指定した最大入力文字数に達した 
場合は，最大入力文字数までを格納する。か/?/?かに指定する- inpptr 構造体は次 
のとおり。 

struct _ inpptr t 

unsigned char max; /* 最大入力文字数*/ 
unsigned char length; /* 実際の入力文字数*/ 
char buff er [256] ; /* 入カ バッファ*/ 

>； 

_ dos _ fgets 関数は DOS コール OxFFIC を発行することによって処理される。 

戻り値-•が指定する- inpptr 構造体の buffer へ入力文字列を格納する。また， 

- inpptr 構造体の length には実際に入力された文字数が格納される。 

関数の戻り値は，最後の CR / LF コードを含まない入力文字数である。 

規 格 — XC 

関連項目- _ dos _ gets ，_ dos_getss 
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—dos—filedate 


用 途ーファイル日付/時刻の読み込みと設定を行う。 

書式- #mclude < sys/aos . h > 

int _ dos_nledate (int flldes , int filedate ); 


解 説 - dos _ filedate 関数はガゴ打で指定したファイルの日付を読み込み，設定する。 

如ぬ切に0を指定した場合，日付/時刻の読み込みを行い，これ以外の値を指定 
した場合に日付/時刻の設定を行う。 

filedate および戻り値のビッ トフィールドの内容は次のとおり。 



YYYYYYYM MMMDDDDD hhhhhmmm mmmsssss 


• sssss 

• TTlTTlTTUTITTlTn 

• hhhhh 

• DDDDD 

參 MMMM 

• YYYYYYY 


秒 （0 〜四）（実際の値は 2 を乗ずる） 
分 （0 〜 59) 

時 （0 〜 23) 

日 (1 〜 31) 

月 （1 〜 12) 

年 （0 〜 "） （1 98 〇年からの相対年数) 


_ dos _ filedate 関数は DOS コール 0 xFF 57(0 xFF 87) を発行することによって処 
理される。 


戻り値——ガ^^於が0の場合には力/ゴ打で指定したファイルの日付/時刻を返す。ただし，戻 
り値の上位16ビットが OxFFFF ならばエラーが発生したことを示す。 

注 意——日付/時刻の設定を行うためには， fildes で栺定 したファイルが書き込み可能な 

モードでオーブンされていなくてはならない。また日付/時刻の設定を行った後 
で，力/ゴ打で指定したファイルに対して書き込みを行うと，設定した日付/時間が 
無効になるので注意すること。したがって設定を行う場合は，必ずクローズ直前 
に行うようにする。 


互換性一 Human 68 k ver .3 では DOS コールの番号が変更 (+0 x 30) されたことに注意す 
ること。 

規 格 — XC 
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—dos—files 


用 途—ファイルを検索する。 

書 式' # include < sys / dos . h > 

void _ dos_files (struct _ fi 丄 buf * bufi , 

const char * file , int atr ); 

解 説—— _ dos_f iles 関数は声 / e で指定したファイル名と a / A •で指定したファイル属性のファ 

イルを検索し，ガ'へその情報をセットする。 

如にはワイルドカードが指定できる。ワイルドカードを指定したとき，最初に 
見つかったファイルが目的のファイルではない場合は， _ dos _ nfiles 関数を使用 
して次のファイルをサーチすることができる。 

atr に指定できる値は次のとおり。 


• 0 x 01 

読み込み専用 

• 0 x 02 

隠しファイル 

• 0 x 04 

ボリューム ID 

• 0 x 08 

システムファイ 

• 0 x 10 

ディレクトリ 

• 0 x 20 

通常のファイル 


この ar /* で指定した厲性とファイル属性の論理積 （ AND ) が0でないファイルは 
サーチの対象となる。したがってすべての属性のファイルを対象とするには ， arr 
に 0 x 3 F を指定する。に指定する _ filbuf 構造体は次のとおり。 


struct _fllbui { 


unsigned char seaxchatr; 
unsigned char driveno; 
unsigned long dirsec; 
unsigned short dirlft; 
unsigned short dirpos; 
char filename[8J; 


/* 検索するファイル属性*/ 

/* ドライブ番号*/ 

/* ディレクトリエントリのセクタ番号*/ 

/* ディレクトリエントリの残りのセクタ数*/ 
/* ディレクトリエントリ内の位置*/ 

/* ファイルのノード名*/ 


char ext [3] ; 


/* ファイルの拡張子名*/ 


unsigned char atr; 
unsigned short time; 
unsigned short date; 
unsigned int ulelen; 


/* ファイル属性*/ 
/* ファイル時刻*/ 
/* ファイル日時*/ 
/* フアイル長*/ 


char name [23 」； 


/* ファイル名*/ 


>； 


_dosiiles 関数は DOS コール 0 xFF 4 E を発行することによって処理される 0 
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戻り値——成功した場合は0を含む正の値を返し，失敗した場合は負の値を返す。通常は0 
が返るが，特殊デバイスドライバが対象の場合は〇以外の正の値の場合もある。 


注 意——読み込み専用の通常ファイルを検索対象としようとして 0 x 21 をが/*に指定して 

も，すべての通常ファイルとすべての読み込み専用ファイルが対象となるので注 
意すること。 

_ filbuf 構造体の searchatr から ext までのメンバは Human 68 k が使用する 
ので，ユーザは変更してはならない。変更した場合， _ dos_nf iles 関数が使用で 
きなくなる。 

_f ilbuf 構造体のメンバ dirpos は file にヮイ ルドカードを指定したときにだけ正 
しく設定され，それ以外の場合は OxFFFF が設定される。また， dirpos が OxFFFF 
の場合は- dos _ nfiles 関数による再検索は行えない 0 



規 格 —— XC 


関連項目- _ dos_nf iles 
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dosfnckey 


用 途一一再定義可能キーの読み込みおよび設定を行なう。 

書 式- # include く sys / dos . h > 

void _ dos_fnckeygt (int ino , char * buff ); 
void _ dos_fnckeyst (int fno , const char * buff ); 

解 説 ——- dosJEnckeygt 関数は/⑽で指定した再定義可能キーの設定を読み込み，結果を 

ゐの指す領域に格納する。 

_ d 0 S _ fn C key S t 関数は/⑽で指定した再定義可能キーをゐ w ガで指定したデータで 
再設定する。 

このとき，読み込みまたは設定するキーによって如#の使用容量が変化する。/⑽ 
とゐ w # の関係は次のとおり。 


fno 

必要サイズ 

キーの 種類 

0 

712 

すべてのキー 

1〜10 

32 (31+ } \0 } ) 

F 1 〜 F 10 

11〜20 

32 (31+ ，\0，） 

SHIFT + F 1 〜 SHIFT + F 10 

21 

6 (5+ ，\0，） 

ROLL UP 

22 

6 (5+ ，\0，） 

ROLL DOWN 

23 

6 (5+，\0，） 

INS 

24 

6 (5+ ，\0，） 

DEL 

25 

6 (5+ ，\0，） 

UP 

26 

6 (5+ ，\0，） 

LEFT 

27 

6 (5+ ，\0，） 

RIGHT 

28 

6 (5+ ，\0，） 

DOWN 

29 

6 (54 -，\〇，） 

CLR 

30 

6 (5+ ，\0，） 

HELP 

31 

6 (5+ ，\0，） 

HOME 

32 

6 (5+ ，\0，） 

UNDO 


なお，本機能は CON デバイスによってサポートされている機能である。 
これら2つの関数は DOS コール 0 xFF 21 を発行することによって趄理される。 

戻り値——なし。 

規 格 — XC 
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dos fputc 


用 途ーファイルハンドルへ文字を出力する。 

書 式- #include <sys/dos .h> 

void _dos_fputc (int code, int fildes ノ； 

解 説—— _dos.fputc 関数は fildes で指定したファイルハンドルへ⑺みの文字を出力する 0 

出カデバイスがキャラクタデバイスの場合は， CTRL+C, CTRL+S, CTRL+P, CTRL+N 
についてブレークチェックが行われる。 

_dos_fputc 関数は DOS コール OxFFID を発行することによつて処理される。 

戻り値-なし。 

規 格 — XC 
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dosfputs 


用 途——ファイルハンドルへ文字列を出力する。 

書式-# include < sys/dos . h > 

void _ dos_iputs ^const char ^ message , mt fildes ); 

解 説- _ dos _ fputs 関数は f / des で指定 したファイルハンドルへ， がで 指定した文 

字列を出力する。文字列は null 文字で終了していなければならない。 

出カ デバイスが キャラクタデバイスの 場合は， CTRL + C , CTRL + S ， CTRL + P , CTRL+N 
についてブレークチヱックが行われる。 

_ dos _ fputc 関数は DOS コール OxFFlE を発行することによって処理される。 
戻り値——なし。 

規 格 — XC 
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_dos_aet_ 


用 途——スレッドの管理情報を取得する。 


書式- #include < sys/dos . h > 

int _ dos _ get_pr (int id , struct _prcptr * buff ); 


解 説—— _ dos _ get _ pr 関数は / ゴで指定したスレッドの管理情報を取得する。 

ただし，/ゴ に一 1を指定し，の メンバ name にバックグラウンドプロセスの名 
前を指定して- dos - get - pr 関数を実行した場合は，戻り値としてバックグラウン 
ドプロセスの ID が，で指定した- prcctrl 構造体に管理情報が返される。ま 
た，/ゴに 一2 を指定すると，自分自身の ID が戻り値として返され，わ W ガで指定し 
た _ p rCC trl 構造体に管理情報が返される。 

わ w ガに指定する _ prcctrl 構造体は次のとおり。 


struct _prcptr て 

struct _prcptr *next_ptr; /* 

unsigned char wait.flg; /* 

unsigned char counter; /* 

unsigned char max_counter; /* 
unsigned char doscmd; /* 

unsigned int psp_id; /* 

unsigned int usp_reg; /* 

unsigned int d_reg [8J; /* 

unsigned int a_regL 广 J; /* 

unsigned short sr.reg; /* 

unsigned int pc_reg; /* 

unsigned int ssp_reg; /* 

unsigned short indosf; /* 

unsigned int indosp; /* 

struct _prcctrl *buf_ptr; /* 

unsigned char name [16]; /* 

long wait_time; /* 

>； 


次の管理領域へのポインタ*/ 

normal=OxOO/wait=OxFF */ 

割り込みごとに減算される*/ 
counter のプリセット値*/ 

DOS コール番号 */ 

プロセス ID */ 
usp レジスタ */ 

データ レジスタ */ 

アドレスレジスタ */ 
sr レジスタ */ 
pc レジスタ */ 
ssp レジスタ */ 

システム予約 */ 

システム予約 */ 

タスク間通信バッファへのポインタ*/ 
スレッドの名前*/ 

待時間の残り（ミリ秒）*/ 



_ dos - get _ pr 関数は DOS コール OxFFFA を発行することによって处理される 0 


戻り値——成功した場合は求めるバックグラウンドブロセスの/ゴを返し，失敗した場合は負 
の値を返す。 

/ゴが不正の場合は OxFFFFOO ?? が返るが，この Ox ?? の部分が指定できる id の最大 
値を示している。また，指定した名前のバックグラウンドプロセスが存在しない 
場合は 一 1を返す。 
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規 格 — XC 


関連項目 


_dos-.change_pr, _dos_kill_pr, _dos_open_pr, _dos_send_pr, _dos_s 丄 eep_pr ， 
_dos_suspend_pr, _dos_time_pr 
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dosgetc 


用 途—キーボードから1文字入力する。 

書式 - #include <svs/dos .h> 

int _dos_getc (void); 

解 説—— _dos_getc 関数はキーが押されるまで待ち，押されたキーコードを返す 0 このと 
き， ブレークチヱ ックを行う。 

_dos_getc 関数は DOS コール 0 xFF 08 を発行することによって処理される 0 
戻り値——入力されたキーコードを返す。 

注 意——ブレークチェックで検査される文字には， CTRL+C (ブレーク）， CTRL+P (ブレー 

ク エコー開始)， CTRL+N (ブレークエコー中止） がある。 

規 格 — XC 

関連項目- _dos_getchar, _dos_inkey 
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—dosgetchar 


用 途一標準入力から1文字読み込む。 

書 式- # include < sys/dos . h > 

int _ dos_getchar ( void ); 

解 説—— _ dos _ getchar 関数は標準入力から 1 文字読み込み，読み込んだ文字を標準出力へ 

エコーバック する。このとき ブレークチェッ クが行われる。 

_ dos _ getcliar 関数は DOS コール OxFFOl を発行することによって処理される 0 
戻り値一標準入力から読み込まれた文字の文字コードを返す。 

注 意—— ブレーク チェックで 検査される 文字には， CTRL+C ( ブレーク）， CTRL+P (ブレー 

クエコー開始)， CTRL+N ( ブレークエコー中止）がある。 

規 格 — XC 

関埋項目- _ dos - getc ，_ dos _ inkey , _ dos _ inpout , _ dos.putchar 
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_dos_getdate 


用 途一現在の日付を取得する。 

書 式- #include < sys/dos . h > 

int _ dos_getdate ( void ); 

m 

• ddddd 日 (1 〜 31) 

• yyyyyyy 年 （ o 〜 99 ) (1980年からの相対年数） 

• WWW 曜日 （ 0 = 日… 6= 土） 

_ dos_getdate 関数は DOS コール 0 xFF 2 A を発行することによって処理される。 

戻り値-現在の日付を返す。 

規 格— XC 

関連項目- _ dos _ gettim 2, _ dos _ gettime , _ dos _ setdate ，_ dos _ settim 2, _ dos.settime 


解 説一 _ dos _ getdate 関数は現在の日付を返す。戻り値のビットフィールドの内容は次の 
通り 。 

00000000 00000 www yyyyyyym mmmddddd 
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—dosgetdpb 


用 途——ドライブパラメータブロックを取得する。 


晋式- #mclude < svs/dos . h > 

int _aos_getdpb (int drive , struct _dDbptr *dpbptr); 


解 説—— - dos _ getdpb 関数は，ゴ / v •阳で指定したドライブのドライブパラメータブロック 
( DPB ) を dpbptr へセッ トする。 drive にはカレントドライブならば0,ドライ 
ブ A : ならば1,ドライブ B : ならば2，以下この順番でドライブ Z : まで設定でき 
る。 dpbptr に指定する _ dpbptr 構造体は次のとおり。 


struct _ dpbptr { 


unsigned 

unsigned 

unsigned 

unsigned 

unsigned 

unsigned 

unsigned 


char drive; 
char unit; 
short byte; 
char sec; 
char shift; 
short fatsec; 
char fatcount; 


unsigned char fatlen; 
unsigned short dircount; 


unsigned short datasec; 


unsigned short maxfat; 


unsigned short dirsec; 
int driver; 


unsigned char id; 
unsigned char fig; 


struct _dpbptr *next; 
unsigned short dirfat; 

char dirbuf[64]; 

>； 


/* ドライブ番号 */ 

/* デバイスドライバで使うユニット番号 */ 
/* 1 セクタ当たりのバイト数 */ 

/* 1 クラスタ当たりのセクタ数 $-$1 */ 

/* クラスタ，セクタ間のシフト数 */ 

/* FAT の先頭セクタ番号 */ 

/* FAT 領域の個数 */ 

/* FAT の占めるセクタ数 */ 

/* ルートディレクトリの個数 */ 

/* データ部先頭のセクタ番号 */ 

/* 総クラスタ数 +1 */ 

/* ルートディレクトリの先頭セクタ番号 */ 
/* デバイスドライバへのポインタ */ 

/* メディアバイト */ 

/* dpb 使用フラグ */ 

/* -1 のときアクセスなし */ 



/* カレントディレクトリのクラスタ番号 */ 
/* (0 のときはルートディレクトリ ）*/ 

/* カレントデイレクトリの文字バッファ */ 


_ dos _ getdpb 関数は DOS コール 0 xFF 32 を発行することによって処理される。 
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戻り値——成功した場合は0を返し，失敗した場合は負の値を返す。 
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—dosgetenv 


用 途——環境変数を取得する。 

僅 iC - #mclude < sys/dos . h > 

int _ dos_getenv (const char * name , const char * env , 
char * buff ); 

解 説- _ dos _ getenv 関数はで指定した環境からで指定した環境変数検索し， 

その値をゐへ格納する。に0を設定すると，親プロセスの環境を対象と 
する。 

_ dos _ getenv 関数は DOS コール 0 xFF 53(0 xFF 83) を発行することによって処理 
される。 

戻り値一失敗した場合は負の値を返す。 

注 意一は256バイト以上の領域を指していなければならない。 

互換性—— Human 68 k ver .3 では DOS コールの番号が変更 （+0 x 30) されたことに注意す 
ること。 

規 格- XC 

関連項目- _ dos_setenv 
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_dos_getfcb 


用 途ーファイルコントロールブロック （ FCB ) を取得す る0 


書 式 - #include <svs/dos .h> 

union _fcb *_dos_getfcb unt fildes;; 


解 説 - _dos_getf cb 関数は fildes で糖定 したファイルのファイルコントロールブロック 

(FCB) を取得する。戻り値の- fcb 共用体は次のとおり。 


union _fcb { 

struct { 

unsigned char dupcnt; 

/* 

unsigned char devattr; 

/* 

void *deventry; 

/* 

char nouse_l[8]; 

/* 

unsigned char openmode; 

/* 

char nouse_2 [21]; 

/* 

char namel[8]; 

/* 

char ext[3]; 

/* 

char nouse_3; 

/* 

char name2[10]; 

/* 

char nouse_4 [38]; 

/* 

} chr; 

/* 

struct { 

unsigned char dupcnt; 

/* 

unsigned char physdrv; 

/* 

void *deventry; 

/* 

unsigned int fileptr; 

/* 

unsigned int exclptr; 

/* 

unsigned char openmode; 

/* 

unsigned char entryidx; 

/* 

unsigned char clustidx; 

/* 

char nouse_2; 

/* 

unsigned short acluster; 

/* 

unsigned int asector; 

/* 

void ホ iobuf; 

/* 

unsigned long dirsec; 

A 

unsigned int fptrmax; 

/* 

char namel[8]; 

/* 

char ext[3]; 

/* 

unsigned char attr; 

/* 

char name2[10]; 

/* 

unsigned short time; 

/* 

unsigned short date; 

/* 

unsigned short fatno; 

/* 


DUP カウント */ 

デバイス属性 */ 

デバイスエントリ */ 

未使用*/ 

才ープンモード */ 

未使用*/ 

ファイル名 1 */ 

拡張子*/ 

未使用*/ 

ファイル名 2 */ 

未使用*/ 

キャラクタデバイス */ 

DUP カウント */ 

物理ドライブ番号*/ 

デバイスエントリ */ 

ファイルポインタ */ 

排他制御情報へのポインタ */ 

才ープンモード */ 

ディレクトリエントリのセクタ内位置 */ 
アクセス中のクラスタ内のセクタ位置 */ 
不明*/ 

アクセス中のクラスタ番号 */ 

アクセス中のセクタ番号 */ 

I/O バッファの先頭 */ 

ディレクトリエントリのセクタ番号 */ 
ファイルポインタの上限 */ 

ファイル名 1 */ 

拡張子*/ 

ファイル属性 */ 

フアイル名 2 本 / 

修正時刻 */ 

修正日付 */ 

先頭 FAT 番号 */ 
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> blk ; 


unsigned long size; 
char nouse_4[28]; 


/* ファイルサイズ */ 
/* 未使用 */ 

/* ブロックデバイス */ 


_ dos _ getfcb 関数は DOS コール 0 xFF 7 C (0 xFFAC ) を発行することによって処理 
される。 

戻り値——成功した場合は指定したファイルのファイルコントロールブロックへのポインタ 
を返し，失敗した場合は負の値を返す。 

互換性一 Human 68 k ver .3 では DOS コールの番号が変更 （+0 x 30) されたことに注意す 
ること。 

規 格- Project LIBC Group 
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— dos—getpdb 


用 途——現在のプロセスのプロセス管理ボインタを求める。 

書 式- #include < sys/dos . h > 

struct _psp *_ dos_getpdb ( void ); 

解 説一 _ dos _ getpdb 関数は現在のプロセスのプロセス管理ポインタを求める。プロセス管 

理ポインタはプログラムの先頭アドレスー OxFO のアドレスであり， Human 68 k 
の管理するメモリブロックの先頭 +0 x 10 に位置する。戻り値の- psp 構造体は次の 
とおり0 


struct _psD { 
char *env; 
void *exit; 
void *ctr 丄 c; 
void *errexit; 
char *comline; 
unsigned char handle [12]; 
void *bss; 
void *heap; 
void *stack; 
void *usp; 
void *ssp; 
unsigned short sr; 
unsigned short abort_sr; 
void *abort_ssp; 
void *trapl0; 
void *trapll; 
void *trapl2; 
void *trapl3; 
void *trapl4; 
unsigned int osflg; 
unsigned char reserve_l [28]; 
char exe_path[68]; 
char exe_name [24]; 
char reserve_2[36]; 

>； 


/* 環境アドレス */ 

/* 終了時の戻りアドレス */ 

/* CTRL+C アポート時の戻リアドレス */ 

/* エラーアボート時の戻りアドレス */ 

/* プロセスのコマンドラインのアドレス */ 

/* プロセスのファイルハンドラの使用状況 */ 
/* bss の先頭アドレス */ 

/* heap の先頭アドレス */ 

/* 初期スタックアドレス */ 

/* 親プロセスの USP レジスタの値 */ 

/* 親プロセスの SSP レジスタの値 */ 

/* 親プロセスの SR レジスタの値 */ 

/* アポート時の SR レジスタの値 */ 

/* アポート時の SSP レジスタの値 */ 

/* tarp #10 のべクタアドレス */ 

/* tarp #11 のべクタアドレス */ 

/* tarp #12 のべクタアドレス */ 

/* tarp #13 のべクタアドレス */ 

/* tarp #14 のべクタアドレス */ 

/* 0 で親プロセスあり， 1 で 0S から起動 */ 
/* 未使用 */ 

/* exec されたファイルのバス名 */ 

/* exec されたファイル名 */ 

/* 未使用*/ 


_ dos _ getpdb 関数は DOS コール 0 xFF 5 l (0 xFF 8 l ) を発行することによって処理 
される。 

戻り値 - 現在の プロセスの /? ゴん 2 ゴゴ r を返す。 
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互換性—— Human 68 k ver .3 では DOS コールの番号が変更 （+0 x 30) されたことに注意す 
ること。 

規 格 —— XC 

関連項目- _ dos_setpdb 
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dosgets 


用 途——文字列を入力する。 

書 式- #include < sys/dos . h > 

int _ dos_gets (struct _inpptr * inpptr ); 

解 説- _ dos_gets 関数は CR/LF コード（改行コード）が入力されるまで文字列を入力す 

る。このとき， inpptr で指定した- inpptr 構造体のメンバ max に設定されている最 
大入力文字数に達した場合は警告音を出力するが，中断はしない。また， CR/LF 
コード（改行コード）が入力された場合は，バッファに書き込む前に null 文字に 
置換される。びに指定する- inpptr 構造体は次のとおり。 

struct _mpDtr { 

unsigned char max; /* 最大入力文字数 */ 
unsigned char length; /* 実際の入力文字数 */ 
char buffer [256] ; /* 入カバッファ */ 

>； 

ブレークチヱックで検査される文字には CTRL+C (ブレーク）， CTRL+S (表示の一時 
停止)， CTRL+P (ブレークエコー開始)， CTRL+N (ブレークエコー停止）がある0 

_ dos.gets 関数は DOS コール OxFFOA を発行することによって処理される。 

戻り値一最後の null 文字を除く入力文字数を返す。 

注 意-ヶが示す- inpptr 構造体の buffer へ入力文字列を格納する。また- inpptr 構 

造体の length には，実際に入力が行われた文字数が格納される。 

関数の戻り値は最後の CR/LF コードを含まない入力文字数である。 

規 格 — XC 


関連項目 - _dos_f gets 
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dosgetss 


用 途—文字列を入力する。 

書式- #mclude < svs/dos . h > 

mt _ dos_getss (struct _inpptr * inpptr ); 

解 説—— _ dos _ getss 関数は，入カデータ中に CR / LF コード（改行コード）が現れるまで文 

字列を入力する。入力中はブレークチヱックを行わず， VOID / NEWLINE が入力され 
ても改行しない。 

入力された文字列は/即"/■で指定した- inpptr 構造体のメンバ length およ 
び buff er へ格納される。このとき，/«/? 〆 /*で指定した _ inpptr 構造体のメン 
バ max に設定されている最大入力文字数に達した場合は警告音を出力するが，中 
断はしない。/>2/7/?ヶに指定する- inpptr 構造体は次のとおり。 

struct _ inpptr { 

unsigned char max; /* 最大入力文字数*/ 
unsigned char length; /* 実際の入力文字数*/ 
char buffer [256] ; /* 入カ バッファ */ 

>； 

_ dos _ getss 関数は DOS コール OxFFlA を発行することによって処理される。 

戻り値-が示す- inpptr 構造体の buffer へ入力文字列を格納する。また ， -inpptr 

構造体の length には実際に入力された文字数が格納される。 

関数の戻り値は，最後の CR ル F コードを含まない入力文字数である。 

規 格 — XC 

関連項目- _ dos _ fgets , _ dos_gets 
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• ssssss 

• TnTnmTnmm 

• hhhhh 


_ dos . gettim 2 関数は DOS コール 0 xFF 27 を発行することによって処理される 0 
戻り値——現在の時刻を返す。 

規格 — XC 

関埋項目- _ dos — getdate , _ dos _ gettime , _ dos _ setdate , _ dos _ settim 2, _ dos_settime 


_dos_gettim2 


用 途——現在の時刻を取得する。 

書式- #include < sys/dos . h > 

int _ dos _ gettim 2 ( void ); 

m 


解 説- _ dos _ gettim 2 関数は現在の時刻を返す。 

戻り値のビットフィールドの内容は次のとおり。 

00000000 000 hhhhh 00 mmminmm 00 ssssss 


9 9 3 
5 5 2 

一 一一 

〇 〇 〇 

/^ ' / —. \ /\ 

秒分時 
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—dos—gettime 


用 途 ——現在の時刻を取得する。 

書式 -# include < sys/dos . h > 

int _ dos_gettime ( void ); 

解 説 —— _ dos _ gettime 関数は現在の時刻を返す。 

戻り値のビットフィールドの内容は次のとおり。 

00000000 00000000 hhhhhmmm mmmsssss 

• sssss 秒 （0 〜 29 )(実際の値は2を乗じる） 

• 1111 nirumnm 分 （0 〜 59) 

• hhhhh 時 (0 〜 23) 

— dos — gettime 関数は DOS コール 0 xFF 2 C を発行することによって処理される。 
戻り値 一現在の時刻を返す。 

規 格 - XC 

関連項目 - dos _ getdate , _ dos _ gettim 2, _ dos _ setdate , _ dos _ settim 2, _ dos.settime 
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_dos_hendsp 


用 途——漢字変換行をコントロールする。 


書 


式- #include < sys / dos . h > 


void _ dos_hendspic 
int _ dos_hendspio 
int _ dos_hendspip 
int _ dos_hendspir 
void _ dos_hendspmc 
int _ dos_hendspmo 
int _ dos_hendspmp 
int _ dos_hendspmr 
void _ dos_hendspsc 
int _ dos_hendspso 
int _ dos_hendspsp 
int _ dos_hendspsr 


(int position ); 
( void ); 

(int position , const 
(int position , const 
( void ); 

( void ); 

(int position , const 
(int position , const 
( void ); 

( void ); 

(int position , const 
(int position , const 


char ^ message ); 
char ^ message ); 


char ^ message ); 
char ^ message ); 


char ^ message ); 
char ^ message ); 


解 説- _dos 上 endspic 関数は以降の変換バッファの内容を変換前の状態へ戻す 0 

_ dos_hendspio 関数は漢字変換ウインドウをオープンする 0 

_ dos_hendspip 関数はで指定した位置から wewfl がの内容をノーマル属 
性で表示する。 

_ dos_hendspir 関数はで指定した位置から wewa がの内容をリバース属 
性で表示する。 

_ dos_hendspmc 関数はモード表示ウ イン ドウをクローズする。 

_ dos_hendspmo 関数はモード表示ウインドウをオープンする。 

_ dos_hendspmp 関数は pas / だ(初で指定した位置から mewa 供の内容をノーマル属 
性で表示する。 

一 dos_hendspmr 関数は pay / r / o/i で 指定した位置から瓜が の 内容を リバース 厲 
性で表示する。 

_ dos_hendspsc 関数は候補ウ イン ドウをクローズする 0 
_ dos_hendspso 関数は候補ウインドウをオープンする。 

_ dos_hendspsp 関数はで指定した位置から mewa がの 内容を ノー マル属 
性で表示する。 

_ dos_hendspsr 関数は/7〇5/你《で指定した位置から wewa がの内容をリバース属 
性で表示する。 
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これらの関数は DOS コール 0 xFF 18 を発行することによって処理される。 


民り値- - dos_hendspic 関数， _ dos_hendspmc 関数， _ dos_hendspsc 関数には戻り値は 

ない0 

_ dos_hendspio 関数は漢字変換ウィンドウの最大表示文字数を返す。 

_ dos_hendspip 関数と— dos_hendspir 関数は漢字変換ウィンドウ内の次の表示位 
置を返す。 

.dosJiendspmo 関数はモード表示ウィンドウの最大表示文字数を返す。 

_ dos_hendspmp 関数と- dos_hendspmr 関数はモード表示ウィンドウ内の次の表示 
位置を返す。 

_ dos_hendspso 関数は候補ウィンドウの最大表示文字数を返す。 

_ dos_hendspsp 関数と- dos 上 endspsr 関数は候補ウィンドウ内の次の表示位置を 
返す。 

注 意-これらの関数は，本来漢字変換フロントエンドプロセッサのためのものなので， 

一般のアプリケーションプログラムから使用するべきではない。 

規 格 — XC 
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dosimportlnenv 


用 途 一 lndrv の管理情報へのボインタを返す。 

書 式 - #include < svs/dos . h > 

int *_ dos_importlnenv ( void ); 

解 説 - _ dos-importlnenv 関数は lndrv が常駐しているかどうかを調べ，常駐していれ 

ばその管理情報へのボインタを返す。 

_ dos.importlnenv 関数は Human 68 k の DOS コールではない 0 

戻り値 —— lndrv が常駐している場合は lndrv の管理情報へのポインタを返し，常駐して 
いない場合は NULL を返す。 

規 格 - Project LIBC Group 

関連項目 - - dos — lfiles , _ dos _ readlink , _ dos_symlink 
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—dos—mdosflq 


用 


途—— Human 68 k のワークフラグ IND 0 S _ FLG のアドレスを取得する。 


* 式- #include < sys/dos . h > 

struct _indos 


( void ); 


解 説- _ dos _ indosflg 関数は， Human 68 k の内部ワークエリアの IND 0 S _ FLG のアドレ 

スを返す。戻り値の- indos 構造体は次のとおり。 


struct _ indos { 

unsigned short indosf; 
unsigned char doscmd; 
unsigned char fat_flg; 
unsigned short retry.count; 
unsigned short retry_time; 
unsigned short verifyf; 
unsigned char breakf; 
unsigned char ctrlpf; 
unsigned char reserved; 
unsigned char wkcurdrv; 

>； 


/* OS 実行フラグ */ 

/* OS 実行中ファンクション番号 */ 

/* FAT 検索モード （ 0= 標準， 0 右先頭から ）*/ 
/* I/O リトライ数（標準で 3 回 ）*/ 

/* I/O リトライ待ち時間（標準で 100(1 秒 ））*/ 
/* ベリファイモード （0 = オフ， 0 关オン ）*/ 

/* ブレークモード （0 = オフ， 1= オン ）*/ 

/* CTRL+P モード （0 = オフ， 0 衣オン ）*/ 

/* システム予約 */ 

/* カレントドライブ （A = 0) */ 


_ dos _ indosflg 関数は DOS コール 0 xFFF 5 を発行することによって®:理される。 


戻り値—— Human 68 k の内部ワークエリアの IND 0 S _ FLG のアドレスを返す。 


注 意——返されるアドレスは スーパー バイ ザ 領域なので， ユーザモー ドではアクセスでき 

ない。また，このアドレス以降は Human 68 k にとって重要なワークエリアなの 
で，書き込みは絶対に行わないこと。 


規 格 — XC 
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dosJnkey 


用 途—キーボードから1文字入力する。 

書式- #include < sys / aos . h > 

int _ dos_inkey 、 void ); 

解 説- _ dos _ inkey 関数はキーが押されるまで待ち，押されたキーコードを返す。このと 

きブレークチェックは 行わない。 

_ dos _ inkey 関数は DOS コール 0 xFF 07 を発行することによって処理される。 
戻り値一^入力されたキーコードを返す。 

注 意——ブレークチヱックは行われないので，ブレークチヱックが必要な場合は- dos_getc 
関数を使用すること。 

規 格 — XC 

関連項目- _ dos _ getc ，_ dos_getchcLr 
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—dos—mpout 


用 途—コンソールの直接入出力を行う。 

邊 式- frinc 丄 ude < sys/dos . h > 

mt _ dos_mpout (mt code ); 

解 説- _ dos_inpout 関数はコンソールに対してみで指定した处理を行う。 

code に OxFF が指定された場合はキー入力を行う。ただしキー入力がなくても入 
力を侍たない。 OxFE か 1旨定された場合はキー センスを 行い，入力したキーコー 
ドを返す。それ以外の場合は⑺みで指定した文字を出力する。 

_ dos_inpout 関数は DOS コール 0 xFF 06 を発行することによって処理される。 

戻り値—— a ? みが OxFF または OxFE の場合は入力されたキーコードを返し，入力がない場 
合は0を返す。なお，文字を出力した場合は無条件に〇を返す。 

注 意——ブレーク チヱ ックは行われない。 

規 格 — XC 

関埋項目- _ dos _ getc , _ aos _ getchar , _ dos _ inkey , _ dos_putchar 
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_dos—intvcg 


用 途 ——割り込みべクタを取得する。 

書 式 - #include < sys/dos . h > 

void *_ dos_mtvcg (mt mtno ;; 

解 説 - _ dos_intvcg 関数は /«加? で指定した 割り込みベクタの 处理アドレスを取得する。 

intno に指定できる値は次のとおり。 

• 0 x 00 〜 OxFF 割り込み処理 

• 0 x 100 〜 OxlFF IOCS コール 

• OxFFOO 〜 OxFFFF DOS コール 

_ dos_intvcg 関数は DOS コール 0 xFF 35 を発行することによって処理される。 
戻り値 ——/が/^で指定したベクタの処理アドレスを返す。 

規 格 — XC 
関連項目 - _ dos_intvcs 
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dosintvcs 


用 途——割り込みベクタを設定する。 

書 式- # include < sys/dos . h > 

void *_ dos_intvcs (int intno , const void * jobaddr ;; 

解 説—— _ dos _ intvcs 関数は⑽⑽で指定した割り込みべクタに，ゾ0ゐ似/みで指定した処理 

アドレスを設定する。 

intno に指定できる値は次のとおり 0 

• 0 x 00 〜 OxFF 割り込み処理 

• 0 x 100 〜 OxlFF IOCS コール 

• OxFFOO 〜 OxFFFF DOS コール 

„ dos _ intvcs 関数は DOS コール 0 xFF 25 を発行することによって処理される。 
戻り値——設定変更前のベクタの処理アドレスを返す。 

規 格- XC 

関連項目-上 os_intvcg 
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_dos—loctrl 


用 途ーデバイスドライバを直接制御する。 


書式 - #include < sys/aos . h > 

int _ dos_ioctrlgt (int fildes ); 

int _ dos_ioctrlst (int fildes , int data ); 

int _ dos_ioctrlrh (int fildes , char * buff , int size ); 

int _ dos_ioctrlwh (int fildes , char * buff , int size ); 

int _ dos_ioctrlrd (int drive , char * buff , int size ); 

int _ dos_ioctrlwd (int drive , char * buff , int size ); 

int _ dos_ioctrlis (int fildes ); 

int _ dos_ioctrlos (int fildes ); 

int _ dos_ioctrldvctl (int drive , int f _ code , char * buff ); 
int _ dos_ioctrldvgt (int drive ); 

int _ dos_ioctrlfdctl (int fildes , int f _ code , char *buf 士ノ； 

int _ dos_ioctrlfdgt (int fildes ); 

int _ dos_ioctrlrtset (int count , int time ); 


解 説—— _ do S _ioctrlgt 関数は，卢ゴ打で指定したファイルハンドルのデバイス情報を調 

ベる。この関数はデバイスドライバによる直接入出力を行うときに使用する。 

_ dos_ioctrlst 関数は fi / des で指定したファイ ルハンドルのデバイス情報を data 
に設定する。力/ゴ打で指定するファイルハンドルは，キャラクタデバイスに対し 
てオープンされたファイルハンドルでなければならない。ぬ / a に設定できるのは 
ビット5の RAW モードの設定のみであり，設定可能な値は次のとおり。 

• 0 x 00 RAW モードに設定 

• 0 x 20 COOKED モードに設定 

_ dos_ioctrlrh 関数は fildes で指定 したファイルハンドルから， s/ze で指定したバ 
イト数分ゐへ読み込む。この関数はデバイスドライバによる直接入力を行うと 
きに使用する。 

_ dos_ioctrlwh 関数は fildes で指定 したファイルハンドルへ，*?加で指定したバイ 
卜数分^から書き出す。この関数はデバイスドライバによる直接出力を行うと 
きに使用する。 

_ dos_ioctrlrd 関数はゴ r/ve で指定したドライブのデバイスドライパから， size で 
指定したバイト数分へ読み込む。この関数はデバイスドライバによる直接入 
力を行うときに使用する。 
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_ dos _ ioctrlwd 関数はゴ r / ve で指定したドライブのデバイスドライパへ， she 
定したバイト数分如#から書き出す。この関数はデバイスドライバによる直接出 
力を行うときに使用する。 

_ dos _ ioctrlis 関数は片み * s •で指定したファイルハンドルの入カステータスを調 
ベる0 

_ dos _ ioctrlos 関数はガゴ打で指定したファイルハンドルの出カステータスを調 
ベる0 

_ dos _ ioctrldvctl 関数はめ*/呢で指定したドライブのデバイスドライバに対して 
f - coc/e を指定して， デバイスドライバによる特殊コントロールを行う。 buff [こは 
デバイスドライバとの情報交換用の領域を指定する。この領域のサイズはデバイ 
スドライバに依存する。また，/_⑺みで指定される処理内容についてもデバイス 
ドライノくに依存する 0 

_ dos _ ioctrldvgt 関数はめで指定したドライブがローカルなのかリモートな 
のかを調べる。 

_ dos _ ioctrlfdctl 関数は fildes で指定 したファイルハンドルに対して f_code た 
指定してデバイスドライバによる特殊コントロールを行う。ゐ I # にはデバイスド 
ライパとの情報交換用の領域を指定する。この領域のサイズはデバイスドライバ 
に依存する。また，/-⑺みで指定される処理内容についてもデバイスドライバに 
依存する。 


_ dos _ ioctrlfdgt 関数は,/ゴ^ J で指定したファイルがローカルなのかリモートな 
のかを調べる。 

_ dos _ ioctrlrtset 関数はリトライ回数を count に， リトライ間隔をだ/泥に設定 
する。デフォルトの値はリトライ回数が3で，リトライ間隔は 100(1 秒）である。 

これらの関数は DOS コール 0 xFF 44 を発行することによって処理される。 

戻り値—— - dos - ioctrlgt 関数はデバイス情報を返す。戻り値のデバイス属性は次のとおり 0 


ビッ 

卜0 

標準入カデバイス （ CON ) 

ビッ 

卜1 

標準出カデバイス （ CON ) 

ビッ 

卜2 

NUL デバイス 

ビッ 

卜3 

CLOCK デバイス 

ビッ 

卜5 

RAW モードかどうか （0 ならば COOKED モード） 

ビッ 

卜6 

特殊 IOCTRL が可能かどうか（このビットが1でなければ， 
_ dos _ ioctrldvctl 関数， _ dos _ ioctrlfdctl 関数は使用でき 


ない） 

•ビット7 キャラクタデノ《イス （0 ならばブロックデバイスであり，ビッ 

卜〇〜4はドライブ番号を表す） 

•ビット12 特殊ブロックデバイスのとき，デバイスがリモートかどうか 
(0 ならばローカル） 
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•ビット 13 
• ビット 14 
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特殊ブロックデバイス （0 ならば通常のブロックデバイス） 
IOCTRL が可能かどうか（このビットが1でなければ， 
_ dos_ioctrlrh 関数， _ dos_ioctrlwh 関数， _ dos_ioctrlrd 
関数， _ dos _ ioctrlwd 関数は使用できない） 

• その他 その他のビットはすべてシステム予約 

ビット 7 が 0 の場合 （ブロック デバイスの 場合)， ビット〇〜 4 はドライブ番号 （0 
〜 25) を示す。 

_ d 0 S _ i 0 C trl S t 関数は，成功した場合は変更後のデバイス情報を返し，失敗した 
場合は負の値を返す。 

_ dos _ ioctrlrh 関数と- dos _ ioctrlrd 関数は，成功した場合は読み込んだバイト 
数を返し，失敗した場合は負の値を返す。 

_ dos _ ioctrlwh 関数と _ dos _ ioctrlwd 関数は，成功した場合は書き込んだパイト 
数を返し，失敗した場合は負の値を返す。 

_ do S _ ioctrlis 関数はデバイスが入力可能ならば一1を返し，入力不可ならば0 
を返す。 

_ d OS _ i OC trl OS 関数はデバイスが出力可能ならば一1を返し，出力不可ならば0 
を返す。 

_ dos _ ioctrldvctl 関数と- dos _ ioctrlfdctl 関数はデバイスドライバによって戻 
り値が異なるが，失敗した場合は負の値を返す。 

_ dos _ ioctrldvgt 関数と- dos _ ioctrlfdgt 関数は，成功した場合はデバイス情報 
を返し，失敗した場合は負の値を返す。 

_ dos _ ioctrlrtset 関数は，失敗した場合は負の値を返す。 

規 格 —— XC 
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—dos—keeppr 


用 途—プロセスを常駐終了させる。 

谨 - # include < svs / dos . h > 

void __ volatiel _ dos_keeppr (int prglen , int code ); 

解 説—— _ dos_keeppr 関数は現在のプロセスを常駐終了させる。 

prglen で指定したサイ ズ分（プロセス管理ポインタの部分を除く）のプログラムが 
常駐し，呼び出した親プロセスには〇?みが終了コードとして返される。このとき 
オープンされているファイル（子プロセスがオープンしたファイルも含む）はすべ 
て クローズ される。 

_ dos_keeppr 関数は DOS コール 0 xFF 31 を発行することによって处理される。 
戻り値——なし。親プロセスには M みが返される。 

規 格- XC 

関連項目- _ dos _ exit , _ dos _ exit 2 
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_dos_keyctrl 


用 途—— CON デバイスの直接入力制御を行う。 


式- #include <sys/dos.h> 

int _dos_k_keyinp (void); 
int _dos_k_keysns (void); 
int _dos_k_sftsns (void); 
int _dos_k_keybit (int group); 
int _dos_k_insmod (int mode); 


解 説 - _dos_k_keyinp 関数はキーボードから 1 文字入力する。 

_dos_k_keysns 関数はキーボードからの入力を先読みする。たたし，“\〇” が返さ 
れた場合は入力がなかったことを示す。 

_d 0S _k_ S ft S n S 関数はシフトキ ーの 押下げ状態を調べる。戻り値の下位 10 ビット 
には各シフト キーの 押下げ状態が返されるが， LED のついているキーについて 
は LED の点灯状態を返す。戻り値の下位 10 ビットの内容は次のとおり。いずれ 
も 該当ビットが1 の 場合に押下されて いる ことを示す。 


10 

9 

8 

7 

6 

5 

全角 

ひらがな 

INS 

CAPS 

コー ド入力 

ローマ字 

4 

3 

2 

1 

0 


かな 

OPT.2 

OPT.1 

CTRL 

SHIFT 




_dos_k_insmod 関数はで指定した状態に INS キーの状態を設定する 0 mode 
に OxFF を設定した場合は ON に， 0 x 00 を設定した場合は OFF になる。 
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_ dos _ k_keybit 関数は grow /? で指定したキーコードグループについて，その押下 
げ状態を調べる。キーコードグループと該当キーのビット位置の関係は次のとお 
り。縦軸がキーコードグループ，横軸がビット位置を表している。 



0 

1 

2 

3 

4 

5 

6 

7 

0 

未定義 

ESC 

1! 

2 " 

3 # 

4 $ 

5 •/• 

6 & 

1 

7 , 

8 ( 

9 ) 

0 

- = 

為 

\ 1 

BS 

2 

TAB 

Q 

W 

E 

R 

T 

Y 

U 

3 

I 

0 

P 

@ 

[ 

CR 

A 

S 

4 

D 

F 

G 

H 

J 

K 

L 

； 

5 


] 

Z 

X 

C 

V 

B 

N 

6 

M 

,< 

. > 

/ ? 

一 

SPACE 

HOME 

DEL 

7 

ROLLUP 

R0LLDN 

UNDO 

4 — 

T 

—> 

1 

CLR 

8 

/ 

本 

- 

7 

8 

9 

+ 

4 

9 

5 

6 

= 

1 

2 

3 

ENTER 

0 

A 



記号 

登録 

HELP 

XF1 

XF2 

XF3 

B 

XF4 

XF5 

かな 

□ —V 

コード 

CAPS 

INS 

ひら 

C 

全角 

BREAK 

COPY 

F1 

F2 

F3 

F4 

F5 

D 

F6 

F7 

F8 

F9 

F10 

未定義 

未定義 

未定義 

E 

SHIFT 

CTRL 

0PT.1 

OPT. 2 

未定義 

未定義 

未定義 

未定義 

F 

未定義 

未定義 

未定義 

未定義 

未定義 

未定義 

未定義 

未定義 


これらの関数は DOS コール 0 xFF 24 を発行することによって処理される。 


戻り値- -dos 上上 eyinp 関数は入力した文字コードを返す。 

_ dos _ k_keysns 関数は先読みした文字コードを返す 0 

_ dos _ k_sftsns 関数と- dos _ k_keybit 関数は，キー状態をビットで返す 0 

_ dos _ k_insmod 関数には戻り値はない。 

規 格 — XC 
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—dos_keysns 


用 途—キーの入力状態の検査を行う。 

僅 式- #include <sys/dos .h> 

int _dos_keysns (void); 

解 説一 _dos_keysns 関数は標準入力の入力状態を検査する。このときブレークチヱック 

が行われる。 

_dos_keysns 関数は DOS コール OxFFOB を発行することによって処理される。 
戻り値——入力がある場合は一1を返し，ない場合は〇を返す。 

注 意—— ブレーク チェックで 検査される 文字には， CTRL+C (ブレーク）， CTRL+P (ブレー 

クエコー開始)， CTRL+N (ブレークエコー停止）がある0 

規 格 — XC 

関連項目- _dos_gets 
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—dos—kflush 


用 途—入カバッファをフラッシュして，キーボード入力を行う。 

書式 - #mcluae <sys/aos .h> 

int _dos_kflushgc kvoid); 

int _dos_kflushgp (void); 

int _dos_kflushgs (struct _inpptr *inpptr); 

int _dos_kflushin (void); 

int _dos_kflushio (int code); 


解 説—— _dos 上 flushgc 関数は，入カバッファをフラッシュして標準入力から 1 文字読み 

込む。このときブレークチヱックが行われる。この処理は入カバッファをフラッ 
シュして， _dos_getc 関数を実行するのと同じである。 

_dos_kflushgp 関数は，入カバッファをフラッシュして標準入力から 1 文字読み 
込み，読み込んだ文字を標準出力へエコーバックする。このときブレークチェッ 
クが行われる。この处理は入カバッファをフラッシュして， _dos_getchar 関数を 
実行するのと同じである。 

_dos_kflushgs 関数は，入カバッファをフラッシュして CR/LF コード （改行 コー 
ド）が入力されるまで文字列を入力する。このとき inpptr で指定した- inpptr 構造 
体のメンバ max に設定されている最大入力文字数に達した場合は警告音を出力す 
るが，中断はしない。また CR/LF コード （改行 コード） が入力された場合は，バッ 
ファに書き込む前に null 文字に置換される。このときブレークチェックが行われ 
る。この処理は入カバッファをフラッシュして， _dos_gets 関数を実行するのと 
同じである。/«/?/?びに指定する- inpptr 構造体は次のとおり。 

struct _ inpptr { 

unsigned char max; /* 最大入力文字数*/ 
unsigned char length; /* 実際の入力文字数*/ 
char buffer [256] ; /* 入カバッファ*/ 

>； 


_dos_kf lushin 関数は，入カバッファをフラッシュしてからキー入力があるまで 
待ち，入力された文字コードを返す。このときブレークチヱックは行われない。 
この处理は入カバッファをフラッシュして， _dos_inkey 関数を実行するのと同じ 
である。 

一 dos_kflushio 関数は，コンソールに対して⑺みで指定した処理を行う。ただ 
し，⑺みに OxFF が指定された場合はキー入力（ただしキー入力がなくても入力 
を待たない）を行い， OxFE が指定された場合はキーセンスを行って，入力した 
キーコードを返す。それ以外の場合は⑺みで指定した文字を出力する。このと 
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きブレークチヱックは行われない。この処理は入カバッファをフラッシュして， 
_ dos_inpout 関数を実行するのと同じである 0 

これらの関数は DOS コール OxFFOC を発行することによって処理される。 

戻り値- _ dos_kflusligc 関数， _ dos_kf lushgp 関数は，読み込んだ文字コードを返す 0 

_ dos_kflushgs 関数は最後の null 文字を除く入力文字数を返す。 

_ dos_kf lushin 関数は入力された文字コードを返す 0 

_ dos_kflushio 関数は，〇?みが OxFF または OxFE の場合は入力されたキーコー 
ドを返し，入力がない場合は〇を返す。また，文字を出力した場合は無条件に〇 
を返す。 

注 意—— _ dos_kflushgc 関数， _ dos_kf lushgp 関数， _dos 上 flushgs 関数において，ブ 
レーク チェックで検査される文字には CTRL+C (ブレーク）， CTRL+P (ブレークエ 
コー開始)， CTRL+N (ブレークエコー停止）がある 0 

規 格 — XC 

関連項目—— _ dos _ getc , _ dos _ getchar , _ dos _ gets , _ dos _ inkey , _ dos_inpout 
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—dos—kill—pr 


用 途—自分自身のプロセスを削除する。 

書 式- #include く sys / dos . h > 

int _ dos __ kill_pr ( void ); 

解 説—— _ dos _ kill _ pr 関数は自分自身のプロセスを削除する。 

常駐終了していたプロセスの場合，同じプロセス ID (タスク管理情報のメン 
バ psp _ id ) をもつすべてのスレッドを削除し，確保されていたメモリをすべて解 
放する。 

_ dos _ kill _ pr 関数を実行する場合は，自分でオーブンしたファイルはすべてク 
ローズし，書き換えたベクタがあるならばすベて元に戻した後で実行すること。 
Human 68 k はスレッドの削除とメモリの解放以外は行わない。 

プロセス内でいくつかのスレッドを登録し実行した後で， _ dos _ exit 関数， 
_ dos _ exit 2 関数でプロセスを終了する場合は，プロセス内でオープンしたスレッ 
ドのみを- dos _ kill _ pr 関数で削除してから，プロセスを終了すること。 

_ dos _ kill _ pr 関数は DOS コール 0 xFFF 9 を発行することによって処理される。 
戻り値——失敗した場合は負の値を返す。 

注 意——メインのスレッドであるプロセスを削除した場合，その後の動作は保証されない。 
規 格 — XC 

関連項目- _ dos _ change _ pr , _ dos _ get _ pr , _ dos_open 一 pr ，_ dos _ send _ pr , _ dos _ sleep _ pr ， 

_ dos—suspend 一 pr ，_ dos _ time_pr 
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_dos」files 


用 途ーシンボリックリンクを処理せずにファイルを検索する。 


書 式 ^- #include <sys/dos.h> 

int _dos_lfiles (struct ilbuf *buff, 

const char *name, int atr); 


解 説—— _dos_lfiles 関数は似/狀で指定したファイル名と a/r で指定したファイル属性 

のファイルを検索し，へその情報をセットする。ただし， -dos_files 関数と 
は異なり， ziame がシンボリックリンクファイルを指しているのに， file のシンポ 
リックリンクファイル自身の情報を検索する。つまり，シンボリックリンクを処 
理せずに検索することになる。 

_dos ユ files 関数は，你にシンボリックリンクファイル以外を指定したか， lndrv 
が常駐していない場合には- dos_files 関数と同じである。ゐばに指定する 
構造体は次のとおり。 


struct _fllbuf i 

unsigned char searchatr; 
unsigned char driveno; 
unsigned long dirsec; 
unsigned short dirlft; 
unsigned short dirpos; 
char filename [8]; 
char ext [3]; 
unsigned char atr; 
unsigned short time; 
unsigned short date; 
unsigned int filelen; 


/* 検索するファイル属性 */ 

/* ドライブ番号 */ 

/* ディレクトリエントリのセクタ番号 */ 

/* ディレクトリエントリの残りのセクタ数 */ 
/* ディレクトリエントリ内の位置 */ 

/* ファイルのノー ド名*/ 

/* ファイルの拡張子名 */ 

/* ファイル属性 */ 

/* ファイル時刻 */ 

/* ファイル日時 */ 

/* ファイル長 */ 


char name[23J ; 


/* ファイル名 */ 


}； 



_dos_lfiles 関数は Human68k の DOS コールではない 0 

戻り値——成功した場合は0を含む正の値を返し，失敗した場合は負の値を返す。通常は0 
が返るが，特殊デバイスドライバが対象の場合は〇以外の正の値の場合もある。 
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注 意- jfilbuf 構造体の searchatr から ext までのメンバは Human 68 k が使用する 

ので，ユーザは 変更してはならない。変更した場合， - dosjifiles 関数が使用で 
きなくなる。 

- filbuf 構造体のメンバ dirpos はにワイルドカードを指定したときにだけ 
正しく設定され，それ以外では OxFFFF が設定される。また， dirpos が OxFFFF 
の場合は ， -dosjof iles 関数による再検索は行えない。 

_ dos _ lfiles 関数の動作はすべて lndrv に依存するため， lndrv 以外のシンポ 
リックリンクドライバでは使用することができない。また，将来 lndrv が変更さ 
れても動作しなくなる可能性がある。 

規 格- Project LIBC Group 

関埋 1 貝目- _ dos . importlnenv , _ dos _ readlink , _ dos_svmlink 


484 




Chapter 2—DOS コールライブラリ 


—dos—link 


用 途——ハードリンクファイルを作成する。 


書 式- #include < sys/dos . h > 

int _ dos_link (const char * src , const char * dst ); 


解 説—— _ dos _ link 関数は， VC と同じファイルの実体を指すようなハードリンクファイル 

ゴ打を 作成す る。 ただし， ゴ对と 同名のファイルがすでに存在す る 場合は失敗する。 

ハードリンクするファイルは同ーファイルシステム上のファイルでなければなら 
ない。ハードリンクファイルの削除は， - dos _ unlink 関数でのみ正常に実行する 
ことができる。 

_ dos _ link 関数は Human 68 k の DOS コールではない。 


戻り値——成功した場合は〇を返し，失敗した場合は負の値を返す。 

注 意一 Human 68 k にはハードリンクの概念がないため， _ dos _ link 関数では実現する 

ために非常に危険な方法を採用している。一般的には， — dos — link 関数が作成す 
るハードリンクファイルは「複数ファイルが同じセクタを指している」という破 
損ファイルとして認識されてしまう。不用意な使用はファイルシステムの破壊に 
なりかねないので注意すること。 



規 格- Project LIBC Group 


関連項目- _dos .unlink 
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—dos—lock 


用 途—ファイルのロックを設定/解除する。 

x \, - #mclude < sys/dos . h > 

mt _ aos_±ock (int fildes , int offset , int len ); 
int _ dos_unlock (int fildes , int offset , int len ); 

解 説—— _ dos ユ ock 関数は fildes で指定したファイ ルに対してロックを行い，他のプロセ 

スからのファイルアクセスを禁止する。 fildes にはロック したいファイルのファイ 
ルハンドルを，0#¢/にはファイル中のロックしたい部分の先頭からのオフセット 
を，/⑼には以からロックする長さをバイト単位で指定する。 

一 dos _ unlock 関数はガゴ es で指定したファイルのロックを解除する。 fildes には 
ロ ックを解除したいファイルのファイルハンドルを， 〇が以 にはファイル中の ロッ 
クを解除したい部分の先頭からのオフセットを，/州には c # 以からロック解除す 
る長さをバイト単位で指定する。 

_ dos _ lock 関数と- dos _ unlock 関数により，ファイルアクセスの排他制御を行い， 
他のプロセスが勝手にファイルを更新できないようにすることができる。 

これらの関数は DOS コール 0 xFF 5 C (0 xFF 8 C ) を発行することによって処理さ 
れる。 

戻り値——失敗した場合は負の値を返す。 


互換性—— Human 68 k ver .3 では DOS コールの番号が変更 （+0 x 30) されたことに注意す 
ること。 

規 格- XC 
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_dos—maketmp 


用 途——指定したパスにテンポラリファイルを作成する。 


書 式- #include < sys/dos . h > 

int _ dos _ maketmp、const char *f lie , mt atr ); 


解 説—— _ dos _ maketmp 関数は如で指定した パス名/ファイル 名のテンポラリファイルを 

が厂で指定した属性で作成する。 

file には ，テンポラリファイルを作成するバス名とテンポラリファイルのファイル 
名を指定する。テンポラリファイルのファイル名は次のような形の文字列を設定 
する。 


file????.txt 


この“？？？？，，の部分は Human68k によって0000〜9999までの数字に変換さ 
れる。このとき“?？？?”の代わりに数字を指定しておくと，その数字から検索さ 
れ，ファイル名が決定する。 0 びに指定するファイル属性は- dos _ create 関数と同 
じである。 

_ dos _ maketmp 関数は DOS コール 0 xFF 5 A (0 xFF 8 A ) を発行することによって処理 
される。 



戻り値——成功した場合は作成したテンポラリファイルのファイルハンドルを返し，失敗し 
た場合は負の値を返す。 

互換性- Human68k ver .3 では DOS コールの番号が変更 （+0 x 30) されたことに注意す 

ること。 

規 格 — XC 

関連項目- _dos .create 


487 







ライブラリー第 2 部 


—dos—malloc 


用 途—メモリを確保する。 

式' -# include <svs/dos.h> 

void *_dos_ma 丄丄 oc (int size;; 

解 説- _dos_malloc 関数は size バイト分のメモリを確保する。 

-dosjnalloc 関数は DOS コール 0xFF48 を発行することによって処理される。 

戻り値——メモリが確保できた場合は確保した領域のアドレスを返し，確保できなかった場 
合は 0x81000000+ 最大バイト数を返す。また，完全に確保できるメモリが不足 
している場合は 0x8200000? を返す。 

注 意一 Size に 0x1000000 以上の値を指定した場合は， OxFFFFFF が指定されたとみなす。 

規 格— XC 
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_dos_malloc2 


用 途ーメモリを指定した方法で確保する。 

書 式- #include < sys/dos . h > 

void *_ dos _ malloc 2 (mt mode , mt size ); 

解 説—— _ d OS jnalloc 2 関数は mo みで指定した割りあてモードで，バイト分のメモリ 
を確保する。 

mode に指定できる値は次のとおり 0 
•0 メモリの下位から探す 

•1 指定サイズを満たすメモリブロックのうち，最小サイズのブロックを割 

りあてる 

•2 メモリの上位から探す 

_ dosjnalloc 2 関数は DOS コール 0 xFF 58(0 xFF 88) を発行することによって処理 
される。 

戻り値——メモリが確保できた場合は確保した領域のアドレスを返し，確保できなかった場 
合は 0 x 81000000+ 最大バイト数を返す。また，完全に確保できるメモリが不足 
している場合は 0 x 8200000? を返す。 

注 意—— size に 0 x 1000000 以上の値を指定した場合は， OxFFFFFF が指定されたとみなす。 

互換性—— Human 68 k ver .3 では DOS コールの番号が変更 (+0 x 30) されたことに注意す 
ること。 

規 格 — XC 
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—dos_memcpv 


用 途—バスエラーが発生するかどうかをテストする。 

式^ # include < sys / dos . h > 

int _ dos 一 memcpy (const void * s _ addr , void * d _ addr , int mode ); 

解 説- _ dos_memcpy 関数は バスエラーが 発生するかどうかをテストする。何もマッピン 

グされていない領域やスーパーバイザ領域など，アクセスしたときに バスエラー 
が発生する可能性のある領域を読み書きできるかどうか，あらかじめテストする 
ことができる。 s - a ゴ办には読み込む領域へのポインタを，ゴ_^7ゴみには書き込む 
領域へのボインタを指定する。 A 7 K ? みにはアクセスするときのバイトサイズを1， 
2，4のいずれかで定する。これらはそれぞれバイト，ワード， ロング ワードを 
示す。 

_ dos_memcpy 関数は DOS コール 0 xFFF 7 を発行することによって処理される。 

戻り値一戻り値が0ならば，読み書きともに可能であることを示し，ゴめ•で指定したア 
ドレスからデータを読み込み， d-addr で指定したアドレスへデータを書き込む。 

戻り値が1ならば， cLaddr で示 したアドレスへの書き込みが失敗したことを示す。 

戻り値が2ならば， s-addr で示 したアドレスからの読み込みが失敗したことを 
示す。 

戻り値が一1ならば， mode が不正または mode に 2, 4を指定したにもかかわら 
ず， s-addr 丨 d-addr が苓数了 ドレスであることを示す。 

s_addr を失 Jt こ亍ス トするため， s_addr / cLaddr 両方で バスエラーが 発生した場合， 
戻り値は2となる。 

注 意-この DOS コールのエントリを， _ dos_intvcs 関数によって変更してはならない。 

規 格- XC 
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_dos_mrree 


用 途——メモリブロックを解放する。 

書 式- #include < sys/dos . h > 

int _ dos_mfree (void * memptr ); 

解 説—— _ dos_mfree 関数は wewp/r で指定したメモリプロックを解放する 0 

memptr には， _ dos_malloc 関数および- dos _ malloc 2 関数によって確保した領域 
へのポインタを指定する 0 したがって， -dosjnalloc 関数および- dos _ malloc 2 関 
数によって確保した領域以外のポインタを wemp びに設定するとエラーとなる。 

memptr に Q を指定すると，自プロセスと子プロセスが$萑保したすべてのメモリ 
ブロックを解放する。 

.dosjnfree 関数は DOS コール 0 xFF 49 を発行することによって処理される 0 
戻り値——成功した場合は〇を含む正の値を返し，失敗した場合は負の値を返す。 

規 格 —— XC 

関連項目- _ dos _ malloc , _ dos _ malloc 2 
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dosmkdir 


用 途——ディレクトリを作成する。 

rf 式- frmc 丄 ude < sys / dos . h > 

mt _ dos_mkdir (const char *f ile ); 

解 説- — dosjnkdir 関数は > で指定したディレクトリを作成する。 

_ dos _ mkdir 問数は DOS コール 0 xFF 39 を発行することによつて処理される。 

戻り値——成功した場合は0を含む正の値を返し，失敗した場合は負の値を返す。通常は0 
が返るが，特殊デバイスドライバが対象の場合は0以外の正の値の場合もある。 

規 格 — XC 

関連項目- _ dos _ chdir ，_ dos_rmdir 
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—dosmove 


用 途——ファイルを移動する。 

書 式- #include < sys/dos . h > 

int _ dos_move (const char * oldfile , const char * newflie ); 

解 説—— _ dos _ move 関数は old file で指定したフ了 イル名を，狀で指定したファイル名 

に変更する。 

_ dos _ rename 関数とは異なり，異なるパス名を指定することによってファイルを 
移動することができる。ただし，異なるドライブ間にまたがる移動は行われない。 

すでにオープンされているファイルに対して実行した場合はエラーとなる。 

_ dos 』 iove 関数は DOS コール 0 xFF 56(0 xFF 86) を発行することによって処理さ 
れる。 


戻り値——成功した場合は0を含む正の値を返し，失敗した場合は負の値を返す。通常は〇 
が返るが，特殊デバイスドライバが対象の場合は〇以外の正の値の場合もある。 

互換性- Human 68 k ver .3 では DOS コールの番号が変更 （+0 x 30) されたことに注意す 

ること。 



規 格 — XC 
関連項目- _ dos_rename 
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dos—nameck 


用 途—ファイル名を解析する。 


式-# include < sys / dos . h > 

int _ dos_nameck (.const char *f ile , struct _nameckbuf * bufi ;; 


解 説—— -dosjiameck 関数は如で指定したファイル名を解析し，その結果をわ w ガで指定 

した領域へ格納する。如#に指定する .nameckbuf 構造体は次のとおり 0 


struct .nameckbuf て 

char drive [2] ; /* ドライブ */ 

char path[65] ; /* パス名（ルート =< V , サブ =< \subdir\’）*/ 
char name [19] ; /* ファイル名 */ 


char ext [5] ; /* 拡張子 */ 


>； 


_ dos_nameck 関数は DOS コール 0 xFF 37 を発行することによつて処理される 0 


戻り値 —— 失敗した場合は負の値を返す。ただし OxFF のときは，ファイルが指定されてい 
ない場合は OxFF を，ワイルド指定がない場合は 0 x 00 を返す。それ以外の場合は 
ワイルド指定があることを表す。 


規 格 — XC 
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dos namests 


用 途—ファイル名を解析する。 


書 式- #include < sys/dos . h > 

int _ dos_namests (const char * file , struct _namestbuf * buff ); 


解 説- _ dos _ namests 関数はガどで指定したファイル名の解析を行い，その結果を解析結 

果を如#で指定した領域へ格納する。如#に指定する Jiamestbiif 構造体は次の 
とおり0 


struct _namestbux { 


unsigned char fig; /* 
unsigned char drive; /* 
char path[65]; /* 
char namel[8]; /* 


0= ワイルドカードなし 0xFF= ファイル指定なし */ 
ドライブ番号 （ A=0, B=l, ..•)*/ 

パス名（ルート =‘\ ，，サブ =‘\subdirV) */ 
ファイル名（先頭 8 文字 ）*/ 


char ext [3] ; /* 拡張子 */ 

char name2[10]; /* ファイル名 （ 9 文字目以降 ）*/ 


}; 


_ dosjQamests 関数は DOS コール 0 xFF 29 を発行することによって処理される 0 


戻り値——成功した場合は〇を含む正の値を返し，失敗した場合は負の値を返す。 



規 格 — XC 
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_dos_newfiie 


用 途—ファイルを新規に作成する。 

書 式^- # include < sys / dos . h > 

int _ dos_newfile (const char *11 丄 e , dosmode^t atr ); 

解 説—— _ dos _ Qewfile 関数は， file で示したファイルを a ヶのファイル属性で新規に作成 
する。 - dos - create 関数と異なり，すでに存在する場合はエラーとなる。 

atr に指定できる値は次のとおり。 


• ビツ 

卜 0 

読み込み専用 

•ビッ 

卜1 

隠しファイル 

• ビッ 

卜2 

システムファイル 

• ビッ 

卜3 

ボリュームラベル 

• ビッ 

卜 4 

ディレクトリ 

籲ビツ 

卜 5 

通常のファイル 


-dosjciewfile 関数は DOS コール 0 xFF 5 B (0 xFF 8 B ) を発行することによって処理 
される。 

戻り値——成功した場合は作成されたファイルハンドルを返し，失敗した場合は負の値を返 
す。ただし，ファイルがすでに存在していた場合は一80を返す。 

互換性—— Human 68 k ver .3 では DOS コールの番号が変更 （+0 x 30) されたことに注意す 
ること。 

規 格 — XC 
関連項目- _do s .create 
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dos.nfiles 


用 


途一 _ dos_files 関数で検索された次のファイルを検索する 0 


書；！^- #mclude < sys/dos . h > 

mt _ dos_nflies (struct _fllebuf * buff ); 

解 説- _ dos_nf iles 関数は- dos_f iles 関数で検索された次のファイルを検索する。 

加#には- dos_f iles 関数で設定された _f ilbuf 構造体へのポインタを指定する、 
と。如#に指定する _filbuf 構造体は次のとおり。 


struct _filbuf { 

unsigned char searchatr; 
unsigned char driveno; 
unsigned long dirsec; 
unsigned short dirlft; 
unsigned short dirpos; 
char filename [8]; 
char ext[3]; 
unsigned char atr; 
unsigned short time; 
unsigned short date; 
unsigned int filelen; 
char name[23]; 

>； 


/* 検索するファイル属性 */ 

/* ドライブ番号 */ 

/* ディレクトリエントリのセクタ番号 */ 

/* デイレクトリエントリの残りのセクタ数 */ 
/* ディレクトリエントリ内の位置 */ 

/* ファイルのノー ド名 */ 

/ * ファイルの拡張子名 */ 

/* ファイル属性 */ 

/* ファイル時刻 */ 

/* ファイル日時 */ 

/* ファイル長 */ 

/* ファイル名 */ 


■ 


—dosjifiles 関数は DOS コール 0xFF4F を発行することによって処理される。 

戻り値一成功した場合は0を含む正の値を返し，失敗した場合は負の値を返す。通常は0 
が返るが，特殊デバイスドライバが対象の場合は0以外の正の値の場合もある。 

注 意- _f ilbuf 構造体の searchatr から ext までのメンバは Human68k が使用する 

ので，ユーザは変更してはならない。変更した場合， _do S _nfiles 関数が使用で 
きなくなる。 

規 格 XC 

関連項目- _dos_f iles 
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_dos—open 


用 途——ファイルをオープンする。 

書 式" # include < sys / dos . h > 

int _ dos_open (const char * file,int mode ); 

解 説—— - dos-open 関数は如で指定したファイルを， /7 K ? みで指定したモードでオープン 
する。 

wo みに指定できる値は次のとおり。 


• 0 x 000 

読み込み 

• 0 x 001 

書き込み 

• 0 x 002 

読み込み，書き込み 

• 0 x 100 

読み込み（辞書用特殊ハンドル） 

• 0 x 101 

書き込み（辞書用特殊ハンドル） 

• 0 x 102 

読み込み，書き込み（辞書用特殊ハンドル) 


_ dos_open 関数は DOS コール 0 xFF 3 D を発行することによって処理される 0 

戻り値一成功した場合はオープンしたファイルハンドルを返し，失敗した場合は負の値を 
返す。 

注 意—— WC ? みに 0 x 100 〜 0 x 102 を指定すると，辞書用の特殊ハンドルを作成するが，こ 

の特殊ハンドルはユーザが使用してはならない。 

規 格一 XC 
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—dos—open— 


用 途——バックグラウンドプロセスを登録する。 


書 式- #include < svs/dos . h > 

mt _dos_ODen_pr (.const char *name,int counter, 

int usp , int ssp , int sr , int pc , 
struct _prcctrl * buff , long sleep _ time ); 

解 説一 _ dos _ open_pr 関数はバックグラウンドプロセスを登録する。登録したスレッドは 
SLEEP 状態となる。 

こは スレッ ドの名前を示す 15 文字以内の文字列へのボイ ン タを指定する 
が，もしで指定した スレッ ドがすでに存在する場合はエラーとなる0 

counter にはタスクを1 回実行するために，タスク切り替えのタイマ割り込みを 
何回カウントするのかを指定する。⑺⑽妙に指定できる値は 2 〜 255 であり， 0 
や1が指定された場合は2が指定されたものとして扱う。 


usp 、 ssp ， Jr の値はそれぞれタスクを実行するときに渡されるレジスタの初期値 
である。システム用のスタックには 6 K バイトが必要である。また， v は0また 
は 0 x 2000 を指定し，実行するプロセスがユーザモードとスーパーバイザモード 
のどちらで実行されるのかを指定する。 0 x 2000 が指定された場合，実行プロセ 
スはスーパーバイザモードで実行される。その他のレジスタはすべて0に初期化 
されプロセスに渡される。 

buff に はタスク間通信用のバッファへのポインタを指定する 0 ゐに指定する 
_prcctrl 構造体の内容は次のとおり。 


struct _prcctrl{ 


long length; 
unsigned char *buf_ptr; 
unsigned short command; 
unsigned short your_id; 


/* デ—タバッファの長さ*/ 

/* データバッファへの ポインタ */ 

/* コマンドバッファ*/ 

/* 相手の ID のバッファ （ -1 で通信許可 ）*/ 


>； 


こは起動するまでの待ち時間をミリ秒単位で指定する。0を指定した場 
合は永久に SLEEP する。 

_ dos _ open.pr 関数により，バックグラウンドプロセスを登録した場合には 
_ d 0 S _ ke e ppr 関数によって常駐終了する。また，スレッドを削除する場合は 
_ dos _ kill_pr 関数を使用する 0 

_ dos _ open_pr 関数は DOS コール 0 xFFF 8 を発行することによって処理される。 


499 






ライブラリー第 2 部 


戻り値——スレッドが登録できた場合はスレッドの ID を返し，失敗した場合は負の値を返 
す。ただし_27が返された場合は，加7狀で指定した名前のスレッドがすでに起 
動されていたことを示し，_29が返された場合はスレッド数が多すぎて起動でき 
なかったことを示す。 

規 格- XC 

関埋 I 貝目 - _dos.change _Dr, _dos_get_pr, _dos_kill_pr, _dos_send_pr, _dos_sleep_pr, 

_dos_suspend_pr, _dos_time_pr 




Chapter 2—DOS コールライブラリ 


dosprint 


用 途一文字列を表示する。 

書 式- #include < sys/dos . h > 

void _ dos.print (const char * msgptr ); 

解 説—— _ dos _ print 関数は w 呀 /7 かで指定した文字列を表示する。このときブレークチェッ 
クが行われる。 

_ dos . print 関数は DOS コール 0 xFF 09 を発行することによつて处理される。 
戻り値一なし。 

注 意 一 表示する文字列は nu 11文字で終端していなくてはならない。 ブレーク チヱックで 

検査される文字には， CTRL+C (ブレーク）， CTRL+S (表示の一時停止)， CTRL+P 
(ブレークエコー開始)， CTRL+N (ブレークエコー停止）がある。 

規 格 — XC 

関連項目- _ dos_gets 
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—dos—prnout 


用 途——プリンタに1文字出力する。 

書 式 - # include <sys/dos .h> 

void _aos Drnout (int code;; 

解 説- _dos_prnout 関数は⑺みで指定した 1 文字をプリンタへ出力する 0 このときブ 

レークチヱックが 行われる。 

_dos_prnout 関数は DOS コール 0xFF05 を発行することによつて处理される〇 
戻り値——なし。 

注 意—— ブレーク チェックで 検査され る 文字は CTRL+C ( ブレーク） のみである。 code に藤 

字コードを直接指定することはできない。この場合は，漢字コードの上位/下位 
の順で1バイトずつ出力すること。 

規 格- XC 

関連項目- _dos_prnsns 
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dosprnsns 


用 途——プリンタへの出力が可能かどうかを調べる。 

書 式- #include < sys/dos . h > 

int _ dos_pmsns ( void ); 

解 説一 _ do S _ priisn S 関数は，現在プリンタへの出力が可能であるかどうかを調べる。 

_ dos _ prnsns 関数は DOS コール OxFFll を発行することによつて处理される 0 

戻り値——プリンタへの出力が可能な場合は〇以外を返し，不可能ならば〇を返す。 

規 格 — XC 
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_dos pspset 


用 途——プロセス管理情報を設定する。 


書 式-# include <sys/dos .h> 

void _dos Dspset (const struct _psp 木 pspaddr); 

解 説—— .dos.pspset 関数は pspaddr で指定したアドレスにプロセス管理情報を書き込む 0 

/7 切 aWr に指定する _psp 構造体は次のとおり。 


struct _psp t 
char *env; 
void *exit; 
void *ctrlc; 
void *errexit; 
char *comline; 
unsigned char handle[12J; 
void ホ bss; 
void *heap; 
void ホ stack; 
void *usp; 
void *ssp; 
unsigned short sr; 
unsigned short abort_sr; 
void *abort_ssp; 
void ホ traplO; 
void *trapll; 
void *trapl2; 
void *trapl3; 
void *trapl4; 
unsigned int osflg; 
unsigned char reserve.1[28]; 
char exe_path[68]; 
char exe_name[24]; 
char reserve_2[36]; 


/* 環境アドレス*/ 

/* 終了時の戻リアドレス*/ 

/* CTRL+C 時の戻りアドレス*/ 

/* エラー時の戻りアドレス*/ 

/* プロセスのコマンドラインのアドレス*/ 

/* プロセスのファイルハンドラの使用状況*/ 
/* bss の先頭アドレス*/ 

/* heap の先頭アドレス*/ 

/* 初期スタックアドレス*/ 

/* 親プロセスの USP レジスタの値*/ 

/* 親プロセスの SSP レジスタの値*/ 

/* 親プロセスの SR レジスタの値*/ 

/* アポート時の SR レジスタの値*/ 

/* アポート時の SSP レジスタの値*/ 

/* tarp #10 のべクタアドレス*/ 

/* tarp #11 のべクタアドレス*/ 

/* tarp #12 のべクタアドレス*/ 

/* tarp #13 のべクタアドレス*/ 

/* tarp #14 のべクタアドレス*/ 

/* 0で親プロセスあり，1で 0 S から起動*/ 

/* 未使用*/ 

/* exec されたファイルのバス名*/ 

/* exec されたファイル名*/ 

/* 未使用*/ 


_dos_pspset 関数は DOS コール 0xFF26 を発行することによって処理される0 


戻り値——なし。 
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意- pspaddr は， Human 68 k のメモリ管理ポインタのアドレス +0 x 10 バイトを指定 

しなくてはならない。そのため - do S _ mall OC 関数で領域を確保し，そのアドレス 
を使用すること。なお， _ ps P 構造体のサイズは240バイトである。 

規 格 — XC 

関連項目- _ dos_malloc 





ライブラリー第 2 部 


—dos_putchar 


用 途一標準出力へ1文字出力する。 

書 式- #include < sys/dos . h > 

void _dos put char (mt code ); 

解 説- _ dos_putchar 関数は， a ? 心で指定した 1 文字を標準出力へ出力する。このとき 

ブレークチェックが 行われる。 

- dos-putchar 関数は DOS コール 0 xFF 02 を発行することによって処理される 0 
戻り値-なし。 

注 意——ブレークチヱックで 検査され る文字には， CTRL+C (ブレーク）， CTRL+S (表示の一 

時停止)， CTRL+P (ブレークエコー開始)， CTRL+N (ブレークエコー停止） がある。 

規 格— XC 

関連項目- _ dos _ getchar , _ dos _ mDout , _ dos_fputc 
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_dos—read 


用 途ーファイルからデータを読み込む。 

書 式- #include <sys/dos .h> 

int _dos_read Cint fildes, char *buff, mt size); 

解 説一 _dos_read 関数は^/打で指定したファイルから， size バイ ト分を Zu/# の指す領 

域に読み込む。 

_dos_read 関数は DOS コール 0xFF3F を発行することによつて处:理される。 

戻り値——成功した場合は読み込んだバイト数を返し，失敗した場合は負の値を返す。ただ 
し，読み込みの最中でファイルの終端に達した場合はそれまでに読み込んだバイ 
卜数を返し，読み込みを開始する前にすでにファイルの終端に達していた場合は 
0を返す。 

規 格一 XC 

関連項目- _dos_write 
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dos—readlmK 


用 途——シンボリックリンクのリンク先を調べる。 

書 式- # include < sys/dos . h > 

int _ dos_readlink (const char * linkpath , 

char * namebuf , int buflen ); 

解 説—— _ dos _ readlink 関数は， Hnkpath で指定したシンボリ ツクリンクファイルが指し 
ているリンク先ファイル (Jinkpath ファイルの中身) のパス名を調べ，その結果を 
で指定した buflen バイ Y の領域にコピーする。 

_ dos _ readlink 関数は Human 68 k の DOS コールではない。 

戻り値——成功した場合は場合は0を返し，失敗した場合は負の値を返す。 

注 意- _ dos _ readlink 関数の動作はすべて lndrv に依存するため， lndrv 以外のシン 

ボリックリンクドライバでは使用することができない。また，将来 lndrv が変更 
されたりしても動作しなくなる可能性がある。 

mzwAw / は最低でも buflen バイ ト以上の領域を指していなければならない。 

規 格- Project LIBC Group 

関連項目- - dos - imporxinenv ，_ dos _ lfiles , _ dos_symlink 






Chapter 2—DOS コールライブラリ 


—dos—rename 


用 途——ファイル名を変更する。 

書式- #include < svs/dos . h > 

int _ dos_rename (const char * oldfile , const char * newflie ); 

解 説—— _ dos _ rename 関数は〇/がかで指定したファイル名を狀で指定したファイル 
名に変更する。すでにオープンされているファイルに対して実行した場合はエ 
ラーとなる。 

_ dos _ rename 関数は DOS コール 0 xFF 56 (0 xFF 86 ) を発行することによって処理 
される。 

戻り値一成功した場合は0を含む正の値を返し，失敗した場合は負の値を返す。通常は〇 
が返るが，特殊デバイスドライバが対象の場合は〇以外の正の値の場合もある。 

互換性一 Human 68 k ver .3 では DOS コールの番号が変更 (+0 x 30) されたことに注意す 
ること。 

規 格 — XC 


関連項目- _dos jnove 







ライブラリー第 2 部 


_dos—retshell 


用 途 ーコマンドシェ ルに ジャンプ する。 

書 式- #include < sys/dos . h > 

void __volatile _ dos_retshell 、 void ); 

解 説- _dosjret shell 関数は，強制的にコマンドシヱルに実行を移す。ただし，スタツ 

クの調整も割り込みべクタの復帰も行われないため，ユーザは使用してはなら 
ない。 

_ dos _ xetshell 関数は DOS コール OxFFFO を発行することによって処理される。 
戻り値一なし。 

規 格- Project LIBC Group 
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_dos—rmdir 


用 途——ディレクトリを削除する。 

書 式- #include < sys/dos . h > 

int _ dos_rmdir (const char * iile ); 

解 説—— _ dos _ rmdir 関数はガどで指定したディレクトリを削除する。 

_ dos _ rmdir 関数は DOS コール 0 xFF 3 A を発行することによつて处理される。 

戻り値——成功した場合は〇を含む正の値を返し，失敗した場合は負の値を返す。通常は〇 
が返るが，特殊デバイスドライバが対象の場合は〇以外の正の値の場合もある。 

規 格 — XC 

関連項目- _ dos _ chdir , _ dos_mkdir 
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_dos_s_malloc 


用 途——メインのメモリ管理下からメモリブロックを確保する。 

書 式- # include < sys/dos . h > 

void *_ dos _ s_malloc unt mode , int size ); 

解 説- _ dos _ s _ malloc 関数は，*5故で指定したバイト数のメモリをメインのメモリ管理 

から確保し，そのポインタを返す。 

mo みに指定できる値は次のとおり0 
•0 メモリの下位から探す 

•1 指定サイズを満たすメモリブロックのうち，最小サイズのブロックを割 
りあてる 

•2 メモリの上位から探す 

_ dos _ sjmalloc 関数は DOS コール 0 xFF 7 D (0 xFFAD ) を発行することによって处 
理される。 

戻り値——メモリが確保できた場合は確保した領域のアドレスを返し，確保できなかった場 
合は 0 x 81000000+ 最大バイト数を返す。完全に確保できるメモリが不足してい 
る場合は 0 x 8200000? を返す。 

注 意—— - dos — sjnalloc 関数は，通常のアプリケーションから使用してはならない 0 また， 
_ dos _ s _ malloc 関数を使用するプログラムは OS から起動され，終了することが 
できない（常駐プロセスのように- dos _ exit 関数や- dos _ exit 2 関数を使用しない） 
プログラムでなくてはならない。 

size に 0 x 1000000 以上の値を指定した場合は， OxFFFFFF が指定されたとみなす。 

互換性- Human 68 k ver .3 では DOS コールの番号が変更 （+0 x 30) されたことに注意す 

ること。 


規 格 一 XC 

関連項目一- dos _ malloc , 一 dos _ mfree , _ dos _ s _ miree , _ dos _ s_process 
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_dos_s_mfree 


用 途ーメインのメモリ管理下のメモリブロックを解放する。 

書式- #include < sys/dos . h > 

11 rt _ dos _ s_mf ree、void * memptr ); 

解 説- _ dos_sjnfree 関数は，びで指定したメインのメモリ管理下のメモリブロッ 

クを解放する。 

memptr に は- dos _ s_malloc 関数で確保した領域へのポインタを指定する。した 
がって，それ以外のポインタをに設定するとエラーとなる。 

m ⑺2/?びが- dos _ s_process 関数で指定しているアドレスで，かつそのスレッド ID 
がカレントスレッド ID ならば，自分自身を削除する。このとき内部のメモリ管 
理で常駐終了しているプロセスはメインのメモリ管理に連結される。 

_ dos_sjnfree 関数は DOS コール 0 xFF 7 E (0 xFFAE ) を発行することによって処理 
される。 

戻り値一親プロセスへは0が返される。 

注 意- _ dos _ s_mfree 関数は，かで指定したメモリブロック中で動作しているプロ 

グラムが存在している状態で実行してはならない。 

互換性- Human 68 k ver .3 では DOS コールの番号が変更 （+0 x 30) されたことに注意す 

ること。 


規 格 — XC 

関連項目- _ dosjnalloc , _ dos _ mfree , _ dos _ s _ malloc , _ dos _ s.process 
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—dossprocess 


用 途——サブのメモリ管理を設定する。 

書 式- # include < sys/dos . h > 

int _ dos _ s_process (int id , int start,int size,int i _ len ); 

解 説- _ dos _ s _ process 関数はサブのメモリ管理を設定する。/ゴにはスレッド ID を指定 

し，於 aW にはサブのメモリ管理の先頭アドレス，にはその領域のバイト数を 
指定する。 

/ゴで指定されたスレッドのメモリ管理はこれ以降この範囲内を対象とする。なお， 
/_/州には新しいメモリ管理の先頭のメモリブロック（必ず確保される）のバイト 
数を指定する。 

_ dos _ s _ process 関数は DOS コール 0 xFF 7 F を発行することによつて处:理される 0 

戻り値一正常に終了した場合はメモリブロックの先頭アドレスを返し，失敗した場合は負 
の値を返す。ただし戻り値が一14ならば，が iJ ⑼+16よりも小さいことを 
示す。 

注 意——打 a バで指定したアドレスから先頭16バイトはメモリ管理領域として使用され破 

壊される。また，スレッド ID の〇番はメインスレッドなので， _ dos _ s_process 
関数で変更することはできない。 

規 格 — XC 

to 連項目- - dos _ ma 丄丄 oc ， _ dos _ mfree , _ dos _ s _ malloc , _ dos _ s_mfree 


514 






Chapter 2—DOS コールライブラリ 


dosseek 


用 途—ファイルポインタを移動する。 

書 式- #include < sys/dos . h > 

int _ dos_seek Unt fildes , int 01 fset,int moae ); 

解 説—— _ dos_seek 関数はガゴ打で指定したファイルのファイルポインタを，みで指定 

した位置から offset バぺ 卜移動する。 

みに指定できる値は次のとおり0 

• 0 ファイルの先頭 

• 1 ファイルの現在位置 

• 2 ファイルの終わり 

_ dos_seek 関数は DOS コール 0 xFF 42 を発行することによつて処理される 0 

戻り値一成功した場合は移動後のファイルポインタのファイル先頭からのオフセットを返 
し，失敗した場合は負の値を返す。 

規 格—— XC 
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_dos—send 


用 途——指定したスレッドに対してコマンドやデータを送り，スレッドが SLEEP してい 

たらスレッドを起こす。 


書 式- # include < sys/dos . h > 

int _ dos _ send_pr (mt my _ id , mt your _ id , mt command , 
char * bufI,long len ); 


解 説—— _ do S _ Se nd _ pr 関数は指定した スレッ ドに対して コマンド やデータを送り，スレッ 
ドが SLEEP していたら スレッ ドを起こす。 

w 少_/ゴには自分のスレッド ID を指定し，少ゴには通信したい相手のスレッド 
ID を指定する。 wmm ⑽ゴには通信の内容を示す値を設定するが，システム定義 
の コマンド 以外は通信を行うスレッド間で任意に定義することができる。システ 
ムで予約している コマン ドは OxFF ?? であり，現在は次に示す コマン ドが定義さ 
れている。 

• 0 xFFF 9 スレッドの削除 

• OxFFFB 強制 SLEEP 状態から起こす（タスク間通信バッファは変化し 

ない） 

• OxFFFC SLEEP を要求する。起こされたとき，このコマンドが送られて 

いたならば，すぐにタスク間通信 バッファの メ ンバ your _ id を 
-1 にして SLEEP に入るべきである。 SLEEP しないでタスク 
間通信 バッファ を監視している場合に有効 

• OxFFFF 処理が終わつたかどうか調べるためのコマンド。 一28 が返れば, 

まだ処理中であることを示す 


タスク間通信用のハ•ッファは- prcctrl 構造体で定義される。この- prcctrl 構造 
体は次のとおり。 


struct _prcctrl t 

long length; /* 
unsigned char *buf_ptr; /* 
unsigned short command; /* 
unsigned short your_id; /* 


デー タ バッファの 長さ*/ 

データバッファへのポインタ */ 

コマンド バッファ*/ 

相手の ID のバッファ （-1 で通信許可）*/ 


>； 


yourJd で指定した スレッドの， タスク間通信ノ くッファの メ ンバ your _ id が一1 の 場 
合に書き込みが可能である。 myJd とコマンドをそれぞれ通信 バッファの your _ id ， 
command に設定し，ゐ w ガから の データを/⑼ バイ トだけ，通信 バッファの buf_ptr 
で指定した領域へ書き込む。そして，/⑼を通信 バッファの length に設定する。 
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指定したスレッドが SLEEP していた場合はスレッドを起こす。特に， OxFFFB 
の コマンドは 特殊处理され，指定した スレッ ドを起こすだけで タスク 間通信 バッ 
フ了の your _ id が-1 でなくてもよく，その他の バッファ も変化しない。 

⑹が タスク間通信 バッファの length よりも大きい場合や書き込み不可能な場合 
はエラーとなる。 

_ dos _ send_pr 関数は DOS コール OxFFFD を発行することによつて処理される。 

戻り値——失敗した場合は負の値を返す。 m 少_/ゴが不正の場合は OxFFFFOO ?? が返るが，この 
“ Ox ??” の部分は指定できる w 少_/ゴの最大値を示している。また， kn が不正の場 
合は 0 x 80?????? を返すが，この “ Ox ??????” の部分は指定できる /⑼の最大値を 
示す。なお，書き込み エラーの 場合は 一 28を返す。 


規 格 — XC 

関連項目—— _ dos _ change _ pr , _ dos _ get _ pr , _ dos _ kill _ pr , _ dos _ open _ pr , _ dos _ sleep _ pr ， 
_do s _ suspend _ pr , _ dos _ time_pr 
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dossetDlock 


用 途——メモリブロックのサイズを変更する。 

書 式-# include < sys/dos . h > 

int _ dos_setblock (void * memptr , mt newsize ); 

解 説—— 胃 dos_setblock 関数は，びで指定したメモリブロックのサイズを狀⑽加に 

変更する。 

memptr に は- dosjnalloc 関数および- dos _ malloc 2 関数によって確保した領域へ 
のポインタを指定する。したがって， _ dos_malloc 関数および- dos jnalloc 2 関 
数によって確保した領域以外のポインタをかに設定するとエラーとなる。 

newsize には，現在のメモリブロックのサイズより大きい値でも小さい値でも指定 
できる。しかし，メモリブロック内部の整合性は自分で管理する必要がある。 

_ dos_setblock 関数は DOS コール 0 xFF 4 A を発行することによって処理される 0 

戻り値一正常にメモリサイズを変更できた場合は終了コードを返し，失敗した場合は負の 
値を返す。ただし，変更できなかった場合は 0 x 81000000+ 最大バイト数を返し， 
完全に変更できるメモリが不足している場合は 0 x 8200000? を返す。 

注 意——狀似加に 0 x 1000000 以上の値を指定した場合は， OxFFFFFF が指定されたとみ 
なす。 

規 格—— XC 

関連項目- _ dos _ malloc , _ dos _ malloc 2 
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_dos_setdate 


用 途—現在の日付を設定する。 

僅 ； rt - #include く sys / aos . h > 

mt _ dos_setdate ^mt date ;; 

解 説一 _ dos _ setdate 関数は現在の日付を設定する。 

ぬに指定するビットフイールドの内容は次のとおり。 


00000000 00000000 yyyyyyym mmmddddd 


• ddddd 日 （1 〜 31) 

• mTnmm 月 （1 〜 12) 

• yyyyyyy 年（〇〜 99 ) (1980年からの相対年数） 

_ dos _ setdate 関数は DOS コール 0 xFF 2 B を発行することによって処理される 0 
戻り値——成功した場合は0を含む正の値を返し，失敗した場合は負の値を返す。 

規 格 — XC 

関埋 r 貝目 - _ dos - getdate ，_ dos _ gettim 2, _ dos _ gettime , _ dos _ settim 2，_ dos_settime 
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dossetenv 


用 途——環境変数を設定する。 

書 式- #include < sys/dos . h > 

int _ dos_setenv const char * name , 

const char * env , const char * buff ); 

解 説一 _ dos_setenv 関数は⑼ v で指定した環境から⑽ me で指定した環境変数を検索し， 
その値をの指す領域に格納する。 

⑼ v に0を設定すると，親プロセスの環境を対象とする。また，に0を設定 
するとの環境変数を削除する 0 

_ dos_setenv 関数は DOS コール 0 xFF 52(0 xFF 82) を発行することによって处理 
される。 

戻り値——失敗した場合は負の値を返す。 

注 意——環境変数には255バイトまでしか設定できない。 

互換性—— Human68k ver .3 では DOS コールの番号が変更 （+0 x 30) されたことに注意す 
ること。 

規 格 — XC 
関連項目- _ dos_getenv 
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—dos—setpdb 


用 途一一管理プロセスを移す。 

書 式- #include < sys/dos . h > 

void _ dos_setpdb Uonst struct _psp 本 pdbaddr ); 

解 説一 _ dos . setpdb 関数は pdbaddr で指定 したプロセスへ実行制御を移す 0 

/?必 a ゴみは制御を移すプログラムの先頭アドレス ー OxFO のアドレスであり， 
_ dos _ getpdb 関数の戻り値でなくてはならない 0 

_ dos _ setpdb 関数は DOS コール 0 xFF 50(0 xFF 80) を発行することによって処理 
される。 

戻り値——制御を移す前のブロセス管理ポインタを返す。 

互換性- Human68k ver .3 では DOS コールの番号が変更 （+0 x 30) されたことに注意す 

ること。 

規 格一 XC 

関連項目- _ dos_getpdb 
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SSSSSS 
1 TTirnTTlTTlTTim 


_ dos _ settim 2 関数は DOS コール 0 xFF 28 を発行することによって®;理される 0 
戻り値——成功した場合は0を含む正の値を返し，失敗した場合は負の値を返す。 

規格 — XC 

関埋項目- - dos _ getdate ，_ dos _ gettim2 ，_ dos _ gettime , _ dos _ setdate , _ dos_settime 


dos settim2 


用 途—現在の時刻を設定する。 

書 式- #include < sys/dos . h > 

int _ dos _ settim2 (int time ); 

解 説- _ dos _ settim2 関数は現在の時刻を " me に設定する 0 

// me に指定するビットフィールドの内容は次のとおり。 

00000000 OOOhhhhh 001111 mmnmm 00 ssssss 


\ — ^/ \/ \^/ 

9 9 3 
5 5 2 

~ ベ ~ 

〇 〇 〇 

/ \ /—\ /—\ 

秒分時 


522 







Chapter 2—DOS コールライブラリ 


_dos—settime 


用 途——現在の時刻を設定する。 

■rf it - #inc 丄 ude < sys/dos . n > 

mt _ dos _ set time (int time ); 

解 説- _ dos _ settime 関数は現在の時刻を " we に設定する。 

time に指定するビットフイールドの内容は次のとおり。 

00000000 00000000 hhhhhmmm mmmsssss 

• sssss 秒 （0 〜2 9 ) ( 実際の値は2を乗じる） 

• mmmmmm 分（〇〜 59) 

• hhhhh 時（〇 〜 23) 

_ dos _ settime 関数は DOS コール 0 xFF 2 D を発行することによつて処理される 0 
戻り値——成功した場合は0を含む正の値を返し，失敗した場合は負の値を返す。 

規 格 — XC 

関埋項目- _ dos _ getdate , _ dos _ gettim2 , _ dos _ gettime , _ dos _ setdate , _ dos _ settim2 
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_dos_sleep_pr 


用 途——カレントスレッド SLEEP 状態にする。 


書 式 -# include <sys/dos .h> 

long _dos_sleep_pr (long time); 


解 説- _dos_sleep_pr 関数はカレントスレッドを SLEEP 状態にする。 time には待ち時 

間をミリ秒単位で指定するが， 0 を指定した場合は永久に SLEEP する。 

SLEEP 状態に入ったスレッド _dos_send_pr 関数によって強制的に起こすことが 
できる。 _dos_send_pr 関数のコマンドが OxFFFB の場合，タスク間通信バッファ 
は変化しないが，それ以外のコマンドの場合はタスク間通信バッファは次のよう 
になる。 


struct _prcctrl{ 
long length; 
unsigned char *buf_ptr; 
unsigned short command; 
unsigned short your_id; 


/* データバッファの 長さ*/ 

/* データ バッファの ポインタ（変化しない）*/ 
/* コマンド番号 */ 

/* 起こしてくれた相手の ID */ 


>； 


SLEEP する前に， データバッファの 内容を処理して からデータバッファのアド 
レスとバイト 数を設定し， タスク 間通信 バッファのメンバ your_id に一 1 を設定 
すること。そうすることで，他の スレッドからの 通信を許可することになる。 

SLEEP していない場合でも， _dos_send_pr 関数によってデータが送られてくる 
場合がある。その場合は SLEEP してもすぐに起こされ，設定した待ち時間が戻 
り f 直として返される。 

_dos_sleep_pr 関数は DOS コール OxFFFC を発行することによって処理される。 


戻り値——待ち時間が経過して起きた場合は一1を返し，タスク間通信バッファは変化しない。 

待ち時間が経過したが， _dos_suspend_pr 関数で止められていたため- dos_send_pr 
関数によって起こされた場合は一 2 を返す。タスク間通信バッファ (i_dos.send_pr 
関数により変化する。 

戻り値が 一1 でも 一2 でもない場合は，侍ち時間の残り時間をミリ秒単位で返す。 
タスク間通信バッファは， _dos_send_pr 関数により変化する。 

規 格- XC 


関埋項目 - 一 aos_change_pr ， _dos_get_pr, _dos_ki 丄 l_pr ， _dos_open_pr, _dos_send 一 pr, 

_dos_suspend_pr, _dos_time_pr, 
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_dos_super 


用 途—— スーパーバイザモー ドと ユーザモー ドとを切り替える。 

書 式- #include < sys / dos . h > 

int _ dos_super ^mt stack ); 

解 説- _dos . super 関数はスーパーバイザモードとユーザモードの切り替えを行う 0 

WacA : が 0 のときには USP レジスタの値を SSP レジスタにセットして，スーパー 
バイザモードへ 切り替える。 打 ac んが〇以外のと きには stack を SSP レジスタに 
セットして，ユーザモードへ 切り替える。 

_ dos _ super 関数は DOS コール 0 xFF 20 を発行することによつて処理される。 

戻り値——成功した場合， smcA : が0のときは切り替える前の SSP レジスタの値を返し，失 
敗した場合は負の値を返す。 

規 格 —— XC 
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dos—super 


用 途——スーパーバイザ領域のプログラムをサブルーチンコールする。 

書式- #include < sys / dos . h > 

void _ dos _ super_jsr (void (* f 皿 c ) (), const struct 一 dregs * inregs , 
struct _dregs * outregs ); 

解 説- _ dos _ super _ jsr 関数はスーパーバイザ領域のプログラムをサブルーチンコール 

する。 

/w 狀 にはサブルーチンコールしたいプログラムの エン トリアドレスを指定し， 
inregs に は呼び出したプログラムへ渡すレジスタを設定する。サブルーチンコー 
ルの 後，⑽ひ级 J にはサブルーチンからリターンするときのレジスタの値が設定さ 
れる。 

_ dos _ super _ jsr 関数は DOS コール 0 xFFF6 を発行することによって处:理される 0 
戻り値-なし。 

注 意- sr レジスタの値は変化しない。また， usp / ssp レジスタはどのような値がプロ 

グラムに渡されるか不定なので，スタックを使った引数渡しは行えない。 

サブルーチンコールした結果，バスエラーやアドレスエラーによって実行が失敗 
した場合でもエラーに対する処理は行わない。 

この DOS コールのエントリを， _ dos _ intvcs 関数によって変更してはならない 0 
規 格 — XC 


526 





Chapter 2—DOS コールライブラリ 


_dos_suspend_pr 


用 途——スレッドを強制的に SLEEP 状態にする。 

式- frinc 丄 ude < sys/aos . h > 

mt _dos_suspend_Dr (int id); 

解 説- _ dos _ suspend _ pr 関数は / ゴで指定したスレッドを強制的に SLEEP 状態にする。 

SLEEP 状態になったスレッドは， _ dos _ send _ pr 関数によって起こされるまで 
SLEEP する 。 

_ dos _ suspend _ pr 関数は DOS コール OxFFFB を発行することによって処理される 0 

戻り値——正常終了した場合は0を返し，失敗した場合は負の値を返す。/ゴが不正の場合は 
OxFFFFOO ?? を返すが，この “ Ox ??” の部分が指定できる z •ゴの最大値を示してい 
る。また，自分自身を指定した場合は一1を返す。 

規 格 — XC 

関埋項目- _ dos-change _ pr ，_ dos _ get _ Dr , _ dos _ kill _ pr , _ dos _ open _ pr , _ dos _ send _ pr , 

_ dos _ sleep _ pr , _ dos _ time_pr 
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—dos—symlink 


用 途——シンボリックリンクフアイルを作成する。 

書 式" #include < sys/dos . h > 

int _ dos_symlink (const char * src , const char * ast ;; 

解 説- _dos _symlink 関数は， src をリンク先とするシンポリックリンクファイルゴ W を 

作成する。ただしみ/と同名のファイルがすでに存在する場合は失敗する。 

_ dos_symlink 関数は Human68k の DOS コ ールではない。 

戻り値——成功した場合は0を返し，失敗した場合は負の値を返す。 

注 意- _ dos_symlink 関数の動作はすべて lndrv に依存するため， lndrv 以外のシンボ 

リックリンクドライバでは使用することができない。また，将来 lndrv が変更さ 
れたりしても動作しなくなる可能性がある。 

規 格- Project LIBC Group 

関埋ェ貝目- _ dos — importlnenv ， 一 dos _ lfiles，_dosjreadlink 
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• ssssssss 

• MMMMMMMM 

• HHHHHHHH 

規格 — XC 


関連項目 —— _dos_change_pr, _dos_get_pr, —dos_ki 丄 l_pr ， _dos_open_pr ， _dos_send_pr, 
_dos_sleep_pr, _dos_suspend_pr 


■ 


_dos_time_pr 


用 途一現在のタイマのカウンタ値を返す。 

書 式 - #include <sys/dos .h> 

int _aos_time_pr ^void); 

解 説 —— -dos—time-pr • 関数は現在のタイマのカウンタ値（ミリ秒単位）を返す。 

_dos_time_pr 関数は DOS コール OxFFFE を発行することによって処理される。 

戻り値 —— 戻り値のビットフィールドの内容は次のとおり。時 / 分 / 秒はすべて BCD 2 桁で 
ある。 

00000000 HHHHHHHH MMMMMMMM SSSSSSSS 


\ —- / \—/ \—/ 

9 9 3 
5 5 2 

一 ~ ~ 

〇 〇 〇 

秒分時 
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dosunliriK 


用 途ーハードリンクファイルを削除する。 

書 式- #include <sys/dos .h> 

int _dos 一 unlink (const char *linkpatn ノ； 

解 説 - _dos _unlink 関数は ， linkp at h で指定しナこハー ドリンクファイルを削除する。 

_dos.unlink 関数は Human68k の DOS コールではない 0 

戻り値一成功した場合は0を返し，失敗した場合は負の値を返す。 

注 意一 Human68k にはハードリンクの概念がないため， _dos_unlink 関数では実現す 

るために非常に危険な方法を採用している。もしハードリンク以外のファイルを 
削除すると「どこからも指されていないセクタ」を作成してしまうことになる。 
不用意な使用はファイルシステムの破壊になりかねないので注意すること。 

規 格一 Project LIBC Group 

関連項目 一 -_dos_link 
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_dos_verify 


用 途—^リファイフラグを設定する。 

■rf 式 - #mclude < sys/dos . h > 

void _ dos_verifv (int flag ); 

解 説- _ dos_verify 関数はベリファイフラグを設定する。 

ル g に指定できる値は次のとおり。 

• 0 ベリファイしない 
•1 ベリファイする 

_ dos_verify 関数は DOS コール 0 xFF 2 E を発行することによって処理される 0 
戻り値——なし。 

規 格 — XC 
関連項目- _ dos_verifyg 
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ライブラリー第 2 部 


_dos_ verity g 


用 途—^リファイフラグの設定状況を取得する。 

書 式- # include < sys/dos . h > 

int _ dos_verifyg ( void ); 

解 説- _ dos _ verifyg 閨数はべリファイフラグの設定状況を取得する 0 

_ dos _ verifyg 関数は DOS コール 0 xFF 54(0 xFF 84) を発行することによつて处理 
される。 

戻り値——ベリファイフラグの設定状況を返す。戻り値は次のとおり。 

• 0 ベリファイしない 
•1 ベリファイする 

互換性—— Human 68 k ver .3 では DOS コールの番号が変更 （+0 x 30) されたことに注意す 
ること。 

規 格 — XC 
関連項目- _dos .verify 
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Chapter 2— DOS コールライブラリ 


—dos—vernum 


用 途- Human 68 k のバージョン番号を返す。 

書式- #include < sys/aos . h > 

mt __const _ dos _ vernum 、 void ); 

解 説 _ dos _ vermim 関数は Human 68 k のバージョン番号を返す。 

戻り値のバージョン番号の値は次に示す形式をとる。 

•下位16ビット 4 68 7 

• 上位16ビット バージョン番号の整数部 X 256+小数部 
_ dos _ vernum 関数は DOS コール 0 xFF 30 を発行することによつて处理される 0 

戻り値- Human 68 k のバージョン番号を返す。 

規 格一 XC 
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ライブラリー第 2 部 


_dos wait 


用 途——自プロセスが直前に実行した子プロセスの終了コードを返す。 

書 式- #include < sys/dos . h > 

int _ dos_wait ( void ); 

解 説—— _ dos _ wait 関数は自プロセスが直前に実行した子プロセスの終了コードを取得 
する。 

_ dos _ wait 関数は DOS コール 0 xFF 4 D を発行することによって処理される。 

戻り値——子プロセスの終了コードを返す。 

規 格 — XC 
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Chapter 2 — DOS コールライブラリ 


—dos—write 


用 途——ファイルへデータを書き込む。 

誉式- #mclude < sys/dos . h > 

mt _ dos_wnte ^mt filaes , const char *buf ±, mt size ); 

解 説—— _ d 0S _write 関数は，が指す領域から j 加バイト分のデータを fildes で指定し 

たファイルへ書き出す。 

_ dos_write 関数は DOS コール 0 xFF 40 を発行することによって処理される。 

戻り値——成功した場合は実際に書き込んだバイト数を返し，失敗した場合は負の値を返す。 

ただし， J 加よりも戻り値が小さい場合や0が返った場合は，ディスクフル（空き 
容量なし）が発生したことを示す。 

注 意——ディスクフルではエラー（戻り値が負の値）とならず，0が返されることに注意す 
ること。 

規 格 —— ZC 
関連項目- _ dos_read 
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Chapter 3 

IOCS コールライブラリ 


本章には X 68000 の IOCS コールライブラリ の マニュアルを 掲載しま 
す。 LffiC では従来のとの互換性を考慮し，名前が異なる以外は基本 
的な動作はすべて同じに作成されています。 

本書では IOCS コールに ついては関数ごとの マニュアルに とどめ，各デ 
バイス （ LSI ) などの詳しい説明はしません。詳しく知りたい場合は，他 
の書籍などを参照してください。 










































































































































































































































ライブラリー第 2 部 


一 iocs_abortjob 


用 途—アボート处理を行う。 

書 式- #include < sys / iocs . h > 

void _ iocs_abortjob 、 void ); 

解 説—— - iocs - abortjob 関数はアボート処理を行う。この機能は Human 68 k が使用す 
るので ユーザは 使用しないこと。 

_ iocs_abort job 関数は IOCS コール OxFF を発行することによつて处理される 0 

戻り値ーリターンしないで， エラーアポー ト ルーチン （ OS の エラーが 出たとき，中止く A > 
を選ぶ）へ制御を移す。 

規 格 — XC 
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Chapter 3— IOCS コールライブラリ 


—iocsabortrst 



用 途—アボートするために環境の再設定を行う。 

書 式- #include < svs/iocs . h > 

void _ iocs_abortrst ( void ); 

解 説一 _ iocs_abortrst 関数はプログラムの処理をアボートするためのフラグをリセッ 

卜し，環境を再設定する。この機能は Human 68 k が使用するので，ユーザは使 
用しないこと。 

_ iocs_abortrst 関数は IOCS コール OxFD を発行することによつて处理される 0 

戻り値-なし。 

規 格 —— XC 
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ライブラリー第 2 部 


joes— adocmam 


用 途—— ADPCM からアレイチェインモードでデータを入力する。 

書 式- #include < sys/iocs . h > 

int _ iocs_adpcmain (const struct _chain * tbl,int mode , mt cnt ); 

解 説- _ iocs _ adpcmain 関数は ADPCM からアレイチェインモードでデータを入力する。 

治/に指定する . chain 構造体は次のとおり 0 

struct _ chain { 

void *addr; /* データバッファの先頭アドレス */ 

unsigned short len; /* データバッファの長さ */ 

}； 

wo みについては- iocs _ adpcminp 関数を参照のこと。また，にはチェインテー 
ブルの個数を指定する。 

_ iocs _ adpcmain 関数は IOCS コール 0 x 63 を発行することによって処理される。 
戻り値——なし。 

規 格 — XC 

関連項目- _ iocs_adpcminp 
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Chapter 3 — IOCS コーノレライブラリ 


—iocs—adpcmaot 



用 途- ADPCM ヘア レイ チヱ イン モードでデータを 出力する。 

書式- #include < sys/iocs . h > 

mt _ iocs_adpcmaot (const struct _chain * tbl,int mode , int cnt ；; 

解 説- _ iocs _ adpcmaot 関数は ADPCM ヘアレイチェインモードでデータを出力する。め/ 

に指定する - chain 構造体は次のとおり。 

struct .chain { 

void *addr ; /* データの先頭アドレス */ 

unsigned short len; /* データの長さ */ 

>； 

wo みについては- iocs _ adpcmout 関数を参照のこと。また，にはチェインテー 
ブルの個数を指定する。 

_ iocs _ adpcmaot 関数は IOCS コール 0 x 62 を発行することによつて处理される。 
戻り値一なし。 

規 格 — XC 

関連項目- _ iocs_adpcmout 
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ライブラリー第 2 部 


—iocs—adpcmmp 


用 途—— ADPCM からデータを入力する。 

書 式- # include < sys / iocs . h > 

int _ iocs_adpcminp (void * addr , int mode,int 丄 en ); 

解 説—— _ iocs _ adpcminp 関数は ADPCM からデータを入力する 0 

ゴみには入カデータの格納ァドレスを指定し，/州には入カデータ長を指定する。 
この指定が OxFFOO バイト以上の場合，入力処理を OxFFOO バイト単位に行うの 
で，関数の処理が完了するには時間がかかる。 

mo みにはサンプリング周波数 X 256+ 出カモードを指定する。 


サンプリ 

ング周波数の指定は次のとおり0 

• 0 

3.9 KHz (1950 バイト/秒） 

• 1 

5.2 KHz (2600 パイト/秒） 

• 2 

7.8 KHz (3900 バイト/秒） 

• 3 

10.4 KHz (5200 バイト/秒） 

• 4 

15.6 KHz (7800 バイト/秒） 


出カ モー ドは モニタ 出力の出カ モー ドであり，出カ モー ドの指定は次のとおり。 

• 0 音声出カカット 

• 1 音声出力左 

•2 音声出力右 

• 3 音声出力両方 

_ iocs _ adpcminp 関数は IOCS コール 0 x 61 を発行することによつて处理される。 
戻り値——なし。 

注 意——データの入力自体はモノラルで行われる。 

規 格 — XC 
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Chapter 3 — IOCS コールライブラリ 


—iocsadpcmlm 


用 途一 ADPCM からリンクアレイチェインモードでデータを入力する。 

式 - frinc 丄 ude <sys/iocs .h> 

mt _iocs_adpcmlin (const struct _chain2 *tbl,int mode); 

解 説一 _iocs_adpcmlin 関数は ADPCM からリンクアレイチェインモードでデータを入力 
する。治/に指定する _chain2 構造体は次のとおり。 

struct _cham2 { 

void *addr ; /* データバッファの先頭アドレス*/ 

unsigned short len; /* データバッファの長さ*/ 

const struct _chain2 *next; /* 次のテーブルアドレス*/ 

>； 

最後の テーブルのメンバ next には 0 を指定する。また， mo ぬについては 
_iocs_adpcminp 関数を参照のこと。 

_ iocs _ adpcmlin 関数は IOCS コール 0 x 65 を発行することによって処理される。 

戻り値-なし。 

規 格一 XC 

関連項目- _ iocs_adpcminp 
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ライブラリー第 2 部 



用 

書 

解 


途—— ADPCM ヘリンクアレイチェインモードでデータを出力する。 

式- # include < sys / iocs . h > 

int _ iocs_adpcmlot (.const struct _ chain 2 * tbl,int mode ); 

説—— _ ioc S _ adpcmlot 関数は ADPCM ヘリンクアレイチェインモードでデータを出力す 
る。め/に指定する- chain 2 構造体は次のとおり。 

struct _chain2 { 


/* データの先頭アドレス */ 
/* データの長さ */ 


void *addr; 
unsigned short len; 


const struct _chain2 *next; /* 次のテーブルアドレス */ 


}； 

最後のテーブルのメンバ next には0を指定する。また， wo みについては 
_ iocs _ adpcmout 関数を参照のこと。 

_ iocs _ adpcmlot 関数は IOCS コール 0 x 64 を発行することによって処理される。 


用 

書 

解 


民り値-なし。 


規 格 ^ XC 
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Chapter 3 — IOCS コールライブラリ 


_iocs_adpcmmod 


用 途—— ADPCM の実行を制御する。 

•rf 1 ¢- #mclude < svs/iocs . h > 

void _ iocs_adpcmmod (int mode ); 

解 説- _ iocs _ adpcmmod 関数は ADPCM の実行を制御する。 

mode に指定できる値は次のとおり。 

• 0 終了 
• 1 中止 

• 2 再開 

_ iocs_adpcmmod 関数は IOCS コール 0 x 67 を発行することによつて％理される。 
戻り値一なし。 

規 格—— XC 
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ライブラリー第 2 部 


一 iocs—adpcmout 


用 途 一 ADPCM へデータを出力する。 

書 式 - # include < sys/iocs . h > 

int _ iocs_adpcmout (const void * addr , int mode , 11 it len ); 

解 説 - _ iocs—adpcmout 関数は ADPCM へデータを出力する 0 

a ぬ W こは出カデータの格納アドレスを指定し，には出カデータ長を指定する。 
ただし，この指定が OxFFOO バイト以上の場合，出力処理を OxFFOO バイト単位 
に行うので，関数の処理が完了するには時間がかかる。 

mo みには サンプリング周波数 X 256+ 出カモードを指定する。サンプリング周波 
数の指定は次のとおり。 

• 0 3.9 KHz (1950 バイト/秒） 

• 1 5.2 KHz (2600 バイト /秒） 

• 2 7.8 KHz (3900 バイト /秒） 

• 3 10.4 KHz (5200 バイト /秒） 

• 4 15.6 KHz (7800 バイト /秒） 

出カモードの指定は次のとおり。 

• 0 音声出カカット 

• 1 音声出力左 

• 2 音声出力右 

• 3 音声出力両方 

_ iocs_adpcmout 関数は IOCS コール 0 x 60 を発行することによって処理される。 

戻り値 -なし。 

規 格— XC 
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Chapter 3—IOCS コーノレライブラリ 


—iocs—adpcmsns 


用 途—— ADPCM の実行モードを調べる。 

書式- #mclude < sys/iocs . h > 

int _ iocs_adpcmsns ( void ); 

解 説- _ iocs _ adpcmsns 関数は ADPCM の実行モードを調べる。 

_ iocs_adpcmsns 関数は IOCS コール 0 x 66 を発行することによって处理される。 

戻り値ービットフィールドで次の値を返す。 



• 0 x 00 

何もしていない 

• 0 x 02 

出力中 (_ iocs _ adpcmout 関数実行中） 

• 0 x 04 

入力中 （_ iocs _ adpcminp 関数実行中) 

• 0 x 12 

出力中 (_ iocs _ adpcmaot 関数実行中） 

• 0 x 14 

入力中 (_ iocs _ adpcmain 関数実行中) 

• 0 x 22 

出力中 (_ iocs _ adpcmlot 関数実行中) 

• 0 x 24 

入力中 （_ iocs _ adpcmlin 関数実行中) 


規 格 — XC 

関連項目- _ iocs _ b _ adpcmain ，_ iocs _ b - adpcmaot ，_ iocs _ b _ adpcminp ，- iocs _ b _ adpcmlin ， 

_iocs_b 一 adDcmlot, _iocs_b_aapcmout 
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ライブラリー第 2 部 


—iocs—akconv 


用 途—— ANK コードからシフト JIS 漢字コードに変換する。 

書式-# include く svs / iocs . h > 

int _ iocs_akconv (int mode , mt code ); 

解 説- _ iocs _ akconv 関数は ANK コードからシフト JIS 漢字コードへの変換を行う 。 code 

には変換する ANK コード （0 x 20 〜 0 x 7 E ， OxAl 〜 OxDF ) を指定する。 

また， wo みには文字種を指定する。文字種は次のとおり。 

•0 ひらがな 
• 1 カタカナ 

_ iocs _ akconv 関数は IOCS コール 0 xA 2 を発行することによって処理される。 

戻り値一一変換したシフト JIS 漢字コードを返すが，上位16ビットが OxFFFF ならばエラー 
が発生したことを示す。 

規 格 — XC 
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Chapter 3— IOCS コールライブラリ 


_iocs_alarmget 



用 途——アラームの時間と処理アドレスを読み込む。 

# it - #mclude < sys/iocs . h > 

int _ iocs_alarmget (int * datetime , int * offtime , int * mode ); 

解 説- _ iocs_alarmget 関数は アラームの 時間と处理アドレスを読み込む。 

_ iocs_alarmget 関数は IOCS コール 0 x 5 F を発行することによって処理される。 

戻り値- datetime , offiime ， mode で指定した領域に アラームの 設定状況を格納する。そ 

れぞれの内容については， _ iocs_alarmset 関数を参照のこと 0 

規 格 — XC 

関連項目- _ iocs_alarmset 
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ライブラリー第 2 部 


iocs alarmmod 


用 途——アラームの禁止/許可を設定する。 

書 式-# include < sys / iocs . h > 

int _ iocs_alarmmod ^mt mode ); 

解 説 一 _ iocs_alarmmod 関数は アラームの 禁止/許可および現在の状態の通知を行う。 

みには，次の値を設定する0 

• 0 禁止 
• 1 許可 

• 2 通知要求 

_ iocs_alarmmod 関数は10 CS コール 0 x 5 D を発行することによつて处理される。 
戻り値 一設定されたアラームの状態を返す。返される値は次のとおり。 

• 0 禁止 
• 1 許可 

規 格— XC 
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Chapter 3— IOCS コールライブラリ 


— iocsalarmset 



用 途——アラームの時間と処理アドレスの設定を行う。 


音 式- #inciude < sys/iocs . h > 

mt _ iocs_alarmset (int aatetime , int offtime , int mode ); 

解 説- _ iocs_alarmset 関数は アラームの 時間と处理アドレスを設定する。 

ぬ时 zVwe に指定するビットフィールドの内容は次のとおり。日/時/分はいずれも 
BCD 2 桁である。曜日に OxOF , 日/時/分に OxFF を指定すると，それぞれ無指定 
となる。ただし，すべてを無^^定にはしないこと。 

0000 WWWW DDDDDDDD HHHHHHHH MNMMMMMM 


• WWWW 

• DDDDDDDD 

• HHHHHHHH 

• MMMMMMMM 


曜日 （0 x 00 〜 0 x 06) (0 x 00 =日曜日） 
日 (0 x 01 〜 0 x 31) 

時 （0 x 00 〜 0 x 23) 

分 （0 x 00 〜 0 x 59) 


offtime にはコンピュータがオフされるまでの時間を指定する。 offlime の値は次の 
とおり。 

• 0 いつまでも OFF しない 

• 0以外 OFF するまでの時間 （1 分単位） 


mo みには処理アドレスを指定する。/710みの値は次のとおり。 0 x 01 〜 0 x 3 F のテ 
レビコント ロールについては - iocs _ tvctrl 関数を參照のこと。また，处理アド 
レスで指定されるプログラムの先頭は 0 x 60 ( bra 命令）でなければならない。 

• 0 パワー ON , テレビオン&コンピュータモード 

•—1 ハ。ワー ON のみ，テレビコントロールはなし 

• 1 〜 0 x 3 F テレビコントロー ル 

• 0 x 40 〜 OxFFFFFFFE 処理アドレス 


_ iocs _ alarmset 関数は10 CS コール 0 x 5 E を発行することによつて处理される。 
戻り値——失敗した場合は一1を返す。 

規 格 — XC 
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ライブラリー第 2 部 


— iocs—apage 


用 途 ——グラフィック画面の書き込みページを設定する。 

書 式 - # include < sys / iocs . h > 

int _ iocs_apage (mt mode ); 

解 説 —— _ io CS _apage 関数はグラフィック画面の書き込みページの設定を行う。 

mode は書き込みページを指定する。指定する値の内容は次のとおり。 

•0 書き込み ページに 〇ぺ ー ジを指定 

• 1 書き込み ページに 1ぺ ー ジを指定 

• 2 書き込みページに2ページを指定 

• 3 書き込みページに3ページを指定 

•-1 現在の書き込みページを調べる 

_ iocs_apage 関数は IOCS コール OxBl を発行することによって处理される。 

戻り値 ——成功した場合，みが一1のときは〇〜3を返し，それ以外の場合は0を返す。 
また，失敗した場合は次の値を返す。 

•—1 グラフィックは使用できない 

• -2 規定外のページを指定した 

•一3 指定したページは現在の画面モードでは設定できない 

規 格— XC 
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Chapter 3— IOCS コーノレライブラリ 


— ■ocsb—Dadfmt 


用 途一不良トラックを登録する。 



式- #mclude < sys/iocs . ii > 

int _ iocs _ b_badfmt (int drive , mt recno , mt mode ；; 

解 説- _ iocs _ b _ badfmt 関数は，ハードディスクの不良トラックを使用不可トラックとし 

て登録する。 

drive には pda X 256を指定する。ぬについては- iocs _ b _ seek 関数を参照の 
こと。 

广沉72〇には256バイト単位のレコード番号を指定し， mode にはインタリ _ブコー 
ドを指定する。通常， 10 M バイトドライブの場合は6を， 20/40 M バイトドライ 
ブの場合は1を指定する。 

_ iocs _ b _ badfmt 関数は IOCS コール 0 x 4 B を発行することによって処理される。 
戻り値——成功した場合は0を含む正の値を返し，失敗した場合は OxFFFFFF ?? を返す。 


規 格 —— XC 

関連項目- _ iocs _ b_seek 
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ライブラリー第 2 部 


_iocs_b_bpeek 


用 途——メモリから1バイトデータ読み込む。 

書 瓦 - #include <svs/iocs.h> 

int _iocs_b_boeek (const void *addr); 

解 説- _iocs_b_bpeek 関数は， a ゴみで指定したアドレスから 1 バイトのデータを読み込 

む。主にユーザモードでスーパーバイザェリアをアクセスするために使用する。 

_iocs_b_bpeek 関数は IOCS コール 0x82 を発行することによって処理される。 
戻り値——読み込んだバイトデータを返す。 

規 格 —— XC 
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Chapter 3—IOCS コールライブラリ 


Jocs_b_bpoke 


用 途—メモリに1バイトデータ書き込む。 

谨式 - ffinclude <sys/iocs.n> 

void _iocs_b_bpoke (void *addr, 11 it data); 

解 説- _iocs_b_bpoke 関数は <2 ゴゴ r で指定したアドレスに，ゴがで指定したデータを 1 

バイト書き込む。主に，ユーザモードでスーパーバイザエリアをアクセスするた 
めに使用する。 

_iocs_b_bpoke 関数は IOCS コール 0x86 を発行することによって処理される。 
戻り値一なし。 

規 格 — XC 
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ライブラリー第 2 部 



用 途——カーソル位置を基準としてテキスト画面をクリアする。 

書式-# include < svs/iocs . h > 

void _ iocs _ b _ clr_ed ( voia ); 
void _ iocs _ b _ clr_st ( void ); 
void _ iocs _ b _ clr_al ( void ); 

解 説—— _ iocs _ b _ clr _ ed 関数は，現在のカーソル位置から最終行右端までのテキスト画面 
をクリアする。 

_ iocs _ b _ clr _ st 関数は，先頭行左端から現在のカーソル位置までのテキスト画面 
をクリアする。 

_ iocs _ b _ clr _ al 関数は，テキスト画面全体をクリアする。カーソルはホームポジ 
シヨンへ戻る。 

これらの関数は IOCS コール 0 x 2 A を発行することによって処理される。 

戻り値-なし。 

規 格 — XC 
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Chapter 3—IOCS コールライブラリ 


_iocs_b_color 


用 途—表示属性を設定する。 

# 式- #include < sys/iocs . h > 

int _ iocs _ b_color (int color ); 

解 説一 - iocs — b — color 関数は，画面の表示属性を⑺ /(?/* で指定した属性に設定する。 

color に指定できる値は次のとおり。 

• 〇 黒 

• 1 水色 

• 2 黄色 

• 3 白 

• 4 黒 

• 5 水色の強調 

• 6 黄色の強調 

• 7 白の強調 

• 8 黒 

•9 水色のリバース 
•10 黄色のリバース 
•11 白のリバース 
• 12 黒 

•13 水色の強調，リバース 
•14 黄色の強調，リバース 
•15 白の強調，リバース 

_ iocs . b _ print 関数は10 CS コール 0 x 22 を発行することによつて処理される。 
戻り値——成功した場合は設定前の属性を返し，失敗した場合は一1を返す。 

規 格一 XC 
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ライブラリー第 2 部 


—iocs_b_consol 


用 途ーテキストの表示範囲を設定する。 

書 式- # include < sys/iocs . h > 

int _ iocs _ b _ consol(mt xs , mt ys,int xl,mt y 丄ノ； 

解 説—— _ iocs _ b . consol 関数は表示範囲の設定を行う。 

M には先頭の X 座標 （0 〜1008までの16の倍数）を指定し，只には先頭の Y 
座標 （0 〜1020までの4の倍数）を指定する。 W には X の桁数-1 (0 〜1；27で 
8ドット単位）を指定し，夕/には Y の桁数一1 (0 〜63で16ドット単位）を指定 
する。 

ただしズと}^の両方が一1であるか，ズ/と少/の両方が一1だった場合は，それぞ 
れ直前までの値を引き継ぐ。 

_ iocs _ b _ consol 関数は IOCS コール 0 x 2 E を発行することによって处理される。 

戻り値——上位16ビットに直前の X の桁数一1を返し，下位16ビットに直前の Y の桁数 
一1を返す。 

規 格- XC 
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Chapter 3 — IOCS コールライブラリ 


Joes b curoff 


用 途— カーソルを 消去する。 

舊式- #mclude < sys/iocs . h > 

void _ iocs _ b_curoif ( void ); 

解 説 - _ iocs _ b _ curoff 関数はカーソルを消去する 0 

_ iocs _ b _ curoff 関数は IOCS コール OxlF を発行することによって処理される。 

戻り値-なし。 

規 格 — XC 
関連項目- _ iocs _ b_curon 
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ライブラリー第 2 部 


一 iocs—b curon 


用 途——カーソルを表示する。 

書 式- # include < sys / iocs . h > 

void _ iocs _ b_curon vvoid ); 

解 説- _ iocs _ b_curon 関数はカーソルを表示する 0 

_ iocs _ b_curon 関数は IOCS コール OxlE を発行することによつて处理される。 

戻り値——なし。 

規 格 一 XC 

関連項目- _ iocs _ b_curoff 
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Chapter 3—IOCS コーノレライブラリ 


_iocs_b_del 


用 途—カーソル表示行を削除する。 

谱 式- #inc 丄 ude < sys/iocs . h > 

void _ iocs _ b_del (int cnt ); 

解 説- _ iocs _ b _ del 関数は，現在のカーソル行から行を削除する。ただし， c がに0 

を指定すると1とみなされる。また， カーソル 位置の X 座標は0となる。 

_ iocs _ b _ del 関数は IOCS コール 0 x 2 D を発行することによって処理される。 
戻り値——なし。 

規 格 — XC 
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ライブラリー第 2 部 


locsbdown 


用 途——カーソル位置を指定行数だけ下へ移動する。 

書 式- #include < sys / iocs . h > 

void _ iocs _ b_down (int cnt ); 

解 説—— _ iocs _ b _ down 関数はカーソル位置を c 咐行下へ移動する 0 カーソル位置が下端を 

越える場合でも， スクロール アップは行われない。なお， ごが に0を指定すると1 
とみなされる。 

_ iocs _ b _ down 関数は IOCS コール 0 x 27 を発行することによつて®;理される。 

戻り値-なし。 

規 格 — XC 
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Chapter 3 — IOCS コールライブラリ 


」 ocs_b_down 


用 途—カーソル位置を1行下へ移動する。 

書 it - #mclude < svs/iocs . h > 

void _ iocs _ b _ down_s ( void ); 

解 説- _ iocs _ b _ down _ s 関数はカーソル位置を 1 行下へ移動する。現在のカーソル位置が 

最下行だった場合はスクロールアツプが行われる。 

_ iocs _ b _ down _ s 関数は10 CS コール 0 x 24 を発行することによって处理される。 

戻り値-なし。 

規 格 — XC 
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ライブラリー第 2 部 


—iocs_b—drvchK 


用 途 ——フロッピーディスクドライブの状態の検査/設定を行う。 

書 式- #include < sys/iocs . h > 

int _ iocs _ b_drvchk (int drive , mt mode ); 

解 説—— _ iocs _ b _ drvchk 関数はみ/把で指定したドライブの状態の検査と設定を行う。 

drive には pda x 256 を指定する 0 /?ぬについては- iocs _ b _ seek 関数を参照のこと 0 
modeK は次の値を指定する。 

•0 状態の検査のみ行う 

• 1 イジヱクトする（イジヱクト禁止の場合は不可） 

• 2 イジエタト禁止1 、 mode = l のイジエクトも禁止） 

• 3 イジエクト許可1 

• 4 ディスクがセットされていないとき LED 点滅 

• 5 ディスクがセットされていないとき LED 消灯 

• 6 イジエクト禁止2 ( mode = l のイジエクトも禁止） 

•7 イジエクト許可2 

• 8 前回の検査後にイジヱクトが行われたかどうかを調べる 
_ iocs _ b _ drvchk 関数は IOCS コール 0 x 4 E を発行することによって理される。 

戻り値—— wo みが〇〜7のとき，次のようなビットフィールドを返す。 

•ビット 0 メディァ誤挿入 

•ビット 1 メディァ挿入 

•ビット 2 ノットレディ 

•ビット 3 ライトプロテクト 

•ビット 4 ユーザに よるイジ エク ト 禁止 

•ビット 5 ハへ ソファ あり 

•ビット 6 イジヱクト禁止 

•ビット 7 LED 点滅 

ビット2，3は wo みが0の場合だけ値をもち，それ以外の場合は0となる。また 
mode が8の場合は， 1ならばイジヱクトしていないことを， 一1 ならばイジヱク 
卜したことを示す。 
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Chapter 3—IOCS コーノレライブラリ 


注 意—— mode の 6〜8は Human 68 k が使用するのでユーザは使用しないこと。 

規 格- XC 

関連項目- „ iocs _ b_seek 
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ライブラリー第 2 部 


Joes o drvsns 


用 途—— ディスクのステータス 情報を調べる。 

書 式- #include < sys / iocs . h > 

int _ iocs _ b_drvsns (mt drive ); 

解 説- _ iocs _ b _ drvsns 関数はみ/ ve で指定したドライブのステータス情報を調べる 0 

ゴ r / ve には/?ぬ X 256 を指定する 0 /?ぬについては- iocs _ b _ seek 関数を参照のこと 0 
_ iocs _ b _ drvsns 関数は IOCS コール 0 x 44 を発行することによって奶理される。 

戻り値——成功した場合，ハードディスクならば〇を含む正の値を，フロッピーディスクな 
らば FDC のステータス情報（負の値もあり得る）を返す。また，失敗した場合は 
OxFFFFFF ?? を返す。 

FDC のステータス情報については， _ iocs _ b _ dskini 関数を参照のこと。 

規 格- XC 

関埋 I 貝目 - _ iocs _ b _ dskini ，_ iocs _ b_seek 
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Chapter 3—IOCS コ — ル ライブラリ 


—iocs b_dsKmi 


用 途—ディスクインタフェイスを初期化する。 

書 式—フロッピーディスクの場合 

#mclude く svs / iocs . h > 

mt _ iocs _ b _ dskini(mt drive , const void * data , int offtime ); 

ハードディスクの場合 
#include < sys / iocs . h > 

int _ iocs _ b_dskmi (int drive , const void * data ); 

解 説- _ iocs _ b _ dskini 関数は，ゴ rzVe で指定したドライブに対応するインタフヱイスを 

初期化する。 

drive には pdax 256 を指定する。/?ゴ a については- iocs _ b _ seek 関数を参照のこと。 

フロ ッ ピー ディスクの場合， ぬ仿 には SPECIFY コマン ドのデータ ア ドレスを指 
定するが， 0 の場合はデフォルトの値 （ OxO 3 ， OxDO ， 0x10) が設定される。また， 
0ガ hhe には モーター オフまでの時間（単位： Vioo 秒）を設定する。これも0の場 
合はデフォルト値 （200, 2秒）が設定される。 

ハードディスクの場合， data には ドライブ パラメータのデータア ドレスを指定す 
るが，0の場合はデフォルト値（0 x 01，0 x 01，0 x 00，0 x 03，0 x 01，0 x 35，0 x 80, 
0 x 00，0 x 00， 0 x 00) が設定される。 

_ iocs _ b _ dskini 関数は IOCS コール 0 x 43 を発行することによつて处理される。 

戻り値一成功した場合，ハードディスクならば0を含む正の値を，フロッピーディスクな 
らば FDC の ステータス 情報（負の値もあり得る）を返す。また，失敗した場合は 
OxFFFFFF?? を返す。 

FDC のステータス情報は次のとおり。 

• ビット 31 〜 24 リザ ルトステータス 3 

•ビット 23〜〇 不定 



リザル トステータス 3の内容は次のとおり。 


•ビット 7 Fault 信号の状態 
• ビット 6 Write Protected 信号の状態 
•ビット 5 Ready 信号の状態 
• ビット 4 TrackO 信号の状態 
•ビット 3 Tow Side 信号の状態 
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• ビット 2 
• ビット1 
•ビット0 


Side Select 信号の状態 
Unit Selectl 信号の状態 
Unit SelectO 信号の状態 


規 格 —— XC 

関連項目- _ iocs _ b _ seek , _ iocs _ b_verify 





Chapter 3—IOCS コールライブラリ 


一 iocs_b_eject 


用 途ーディスクのイジェクトを行う。 



書式- #include く svs/iocs 上〉 

int _ iocs _ b_eject (int drive ); 

解 説一 _ iocs _ b_eject 関数は，ゴ/7•把で指定したドライブのメディアをイジヱクトする 0 

_ iocs _ b_eject 関数はイジ x クト禁止状態でもイジェクトを行う。また，ハード 
ディスク の 場合はシッピング（未使用シリン ダへ ヘッドを シー ク）する。 

drive には pda x 256 を指定する。ぬについては _ iocs _ b_seek 関数を參照のこと。 

_ iocs _ b_eject 関数は IOCS コール 0 x 4 F を発行することによって処理される。 

戻り値——成功した場合は0を含む正の値を返し，失敗した場合は OxFFFFFF ?? を返す。 


規 格一 XC 

関連項目- _ iocs _ b_seek 
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ライブラリー第 2 部 


—iocs—b—era 


用 途ーカーソル位置を基準としてテキスト画面をクリアする。 

書 式-# include < sys/iocs . h > 

void _ iocs _ b _ era_ed ( void ); 
void _ iocs _ b _ era_st ( void ); 
void _ iocs _ b _ era_al ( void ); 

解 説—— _ iocs _ b _ era_ed 関数は，現在のカーソル位置から行右端までのテキスト画面をク 

リアする。 

_ i OCS _ b_ era _st 関数は，行左端から現在のカーソル位置までのテキスト画面をク 
リアする。 

_ iocs _ b _ er a_al 関数は，カーソルのある行全体をクリアする。 

これらの関数は IOCS コール 0 x 2 B を発行することによって処理される。 

戻り値——なし。 

規 格- XC 
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Chapter 3—IOCS コールライブラリ 


iocsb 


用 途ーディスクの物理フォーマットを行う。 

j-i - #mclude < sys/iocs . h > 

int _ iocs _ b_format (int drive , 

int recno , int len , const void * addr ); 

解 説- _ iocs _ b _ format 関数はディスクの物理フォーマツトを行う。 

ゴ r/ve には/?ぬ X 256 +W 0 みを指定する。 drive ， pda ， mode , r 代720については 
_ iocs _ b _ seek 関数を参照のこと。 

fen にはバイ ト数を指定するが，ハードディスクの場合はインタリーブコードを指 
定する。通常，インタリーブコードは 10 M バイトドライブの場合は6を， 20/40 M 
バイトドライブの場合は1を指定する。 

沉 Wr には ID データの先頭アドレスを指定する。ただし，ハードディスクに対し 
ては不要である。このアドレスには，スーパーバイザ領域も指定できるので注意 
すること。 

_ iocs _ b _ format 関数は IOCS コール 0 x 4 D を発行することによって处;理される。 

戻り値——成功した場合，ハードディスクならば〇を含む正の値を，フロッピーディスクな 
らば FDC のステータス情報（負の値もあり得る）を返す。また，失敗した場合は 
OxFFFFFF?? を返す。 

フロッピーディスタの場合，物理フォーマットに失敗してもエラー終了とはなら 
ず， FDC のステータス情報を返す。 

返される FDC のステータス情報については， _ iocs _ b _ verify 関数を参照のこと。 
規 格 —— XC 



関連項目- _ iocs _ b _ seek ，_ iocs _ b_verify 
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ライブラリー第 2 部 


—iocs—b—ms 


用 途ーカーソル表示行の直後に行を追加する。 

書式- #inc 丄 ude < sys / iocs . h > 

void _ iocs _ b_ins (int cnt ); 

解 説—— _ iocs _ b _ ins 関数は現在の カーソル 行の直後に c 拊行追加する。ただし， cnt [ Z 0 
を指定すると1とみなされる。また， カーソルの X 座標は0となる。 

_ iocs _ b _ ins 関数は IOCS コール 0 x 2 C を発行することによって処理される。 

戻り値-なし。 

規 格 — XC 
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Chapter 3 — IOCS コールライブラリ 


_iocs_b_intvcs 


用 途——割り込みベクタを設定する。 

xt - #mclude <svs/iocs .h> 

void *_iocs_b_intvcs (int vector, void *addr); 

解 説一 -iocs_b_intvcs 関数は割り込みベクタの設定を行う。 

vec 如 r にはべクタ番号を指定し， 0 ゴみには処理アドレスを指定する。 0x00 〜 OxFF 
は割 り 込みべクタ処理のアドレス， 0x100 〜 OxlFF は IOCS コールの 処理アドレ 
スである。 

割り込みベクタルーチンの最後は “rte”，IOCS コール割り込みルーチンの最後 
は “rts” を指定する。 

-iocs.b_intvcs 関数は IOCS コール 0x80 を発行することによって処理される。 
戻り値——設定前の処理アドレスを返す。 



規 格- XC 
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ライブラリー第 2 部 


__ocsb_keymp 


用 途—キーコードの読み込みを行う。 

書式-# include < sys / iocs . h > 

mt _iocs_b_keymD ( void ); 

解 説—— _ iocs _ b 上 eyinp 関数はキーコードの読み込みを行う。また，電卓機能が処理さ 

れる。 

_ io C s _ b _ keyinp 関数は IOCS コール 0 x 00 を発行することによって処理される。 

戻り値-スキャンコード ><256+内部コードを返す。スキャンコードは， _ iocs _ bitsns 関 

数によって指定する キー コードグルーブを8倍したものに，そのグループ内の 
キーのビット位置の番号を加えたものである。たとえば‘ A ’ が押された場合，グ 
ループは3,ビット位置は6なので， 3 x 8+6 = OxlE となる。 

規 格- XC 

関連項目- _iocs_bitsns 
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Chapter 3—IOCS コーノレライブラリ 


—iocs—Dkeysns 


用 途——キーの先行入力の検査を行う。 

•rf 式- frinc 丄 ude < sys / iocs . h > 

int _ iocs _ b_kevsns ( void ); 

解 説—— _ iocs _ b _ keysns 関数はキーの先行入力があるかどうかを調べる。また，電卓機能 
が処理される。 

_ iocs _ b _ keysns 関数は IOCS コール 0 x 01 を発行することによって处理される。 

戻り値一 0 x 10000+ スキャンコード X 256+ 内部コードを返す。スキャンコードについては， 
_ iocs _ b _ keyinp 関数を参照のこと。0の場合は先行入力がないことを示す。 

規 格 —— XC 

関連項目- _ iocs _ b_keyinp 
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ライブラリー第 2 部 


_iocs_b」eft 


用 途——カーソル位置を指定桁数だけ左へ移動する。 

書 式- # include < sys / iocs . h > 

void _ iocs _ b_left ^mt cnt ); 

解 説—— _ iocs _ b _ left 関数は カーソル 位置を桁左へ移動する。 カーソル 位置が左端を 

越える場合でも，右スクロールは行われない。なお ， c がに0を指定すると1と 
みなされる。 

_ iocs _ bJLeft 閨数は IOCS コール 0 x 29 を発行することによって処理される。 

戻り値-なし。 

規 格 — XC 


576 





Chapter 3—IOCS コールライブラリ 


iocsb—locate 


用 途—カーソル位置を設定する。 

書式 - #include <svs/iocs .n> 

mt _iocs_b_locate (int x,int y); 

解 説- _iocs_b_locate 関数は カーソル 位置をズと 少で 指定した座標に設定する。ただ 

し，ズに一1を指定した場合は現在のカーソル位置の通知を行う。 

_iocs_b-locate 関数は IOCS コール 0x23 を発行することによって处理される。 

戻り値-上位 16 ビットに設定前の カーソル 位置の X 座標を返し，下位 16 ビットに Y 座 

標を返す。 



規 格 — XC 
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ライブラリー第 2 部 


locsblpeek 


用 途——メモリから1ロングワードデータ読み込む。 

書 式- #include く sys/iocs.h> 

int _iocs_b_lpeek (const void *addr); 

解 説 一 - _iocs_b_lpeek 関数は，ゴみで指定したアドレスから 1 ロングワー ドデータ読み 

込む。主にユーザ モー ドで スーハ。ーハ * イザエリアをアクセスするために使用する。 
ただし， X68000 ではで指定するアドレスは，偶数アドレスでなければな 
らない。 

_iocs_bJLpeek 関数は IOCS コール 0x84 を発行することによつて处理される。 
戻り値——読み込んだロングワードデータを返す。 

規 格- XC 
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Chapter 3—IOCS コールライブラリ 


—iocsb—lpoke 


用 途ーメモリに1ロングワードデータ書き込む。 



書式- #mclude < sys/iocs . h > 

void 一 iocs _ b_lpoke (voia * addr , int data ); 

解 説- _ iocs_b ユ poke 関数はゴゴ r で指定したアドレスにゴで指定した1ロングワー 

ドデータを書き込む。主にユーザモードでスーパーバイザエリアをアクセスする 
ために使用する。ただし， X 68000 では0ゴみです旨定するアドレスは，偶数アド 
レスでなければならない。 

_ iocs _ b_lpoke 関数は IOCS コール 0 x 88 を発行することによって処理される。 
戻り値一なし。 


規 格 — XC 
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ライブラリー第2部 


_iocs_b memset 


用 途——メモリへデータを書き込む。 

書式-# include < sys / iocs . h > 

void _ iocs _ b_memset (.void * addr , const void *buf I,int len ); 

解 説—— _ i 0 cs _ b _ mem S et : 関数は，如ガで指定したバッファから/⑼で指定したバイト数の 
データをゴみで指定したアドレスへ転送する。ただし，/⑼には転送するバイト 
数一1を指定する。 

_ iocs_bjnemset 関数は IOCS コール 0 x 89 を発行することによって処理される 0 
戻り値——なし。 

注 意——転送元と転送先の領域が重なってはいけない。 

規 格 — XC 
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iocs b memstr 


用 途——メモリからデータを読み込む。 


僅エ C - #include < sys / iocs . h > 

void _ iocs _ b_memstr (const void * addr , void * buff , int len ); 

解 説- _ iocs _ bjnemstr 関数は， a ゴゴ r で指定したアドレスから/⑼で指定したバイト数 

の データを読み込み，結果を で 指定した バッファへ 格納する。ただし，/^? 
には読み込む バイ ト数 一1 を指定する。 

_ iocs _ b _ memstr 関数は IOCS コール 0 x 85 を発行することによって处理される。 



戻り値——なし。 


注 意——転送元と転送先の領域が重なってはいけない。 


規 格 — XC 
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ライブラリー第 2 部 


—iocs b prmt 


用 途—文字列を表示する。 

書式- #include < sys/iocs . h > 

int _ iocs _ b_pnnt (const char ^ message ；; 

解 説- _ iocs _ b _ print 関数は me 肌 7 供で指定した文字列を表示する。供で指定す 

る文字列は null 文字で終了していること。 

_ iocs _ b _ print 関数は IOCS コール 0 x 21 を発行することによって処理される。 

戻り値一上位16ビットに表示後のカーソル位置の X 座標を返し，下位16ビットに Y 座 
標を返す。 

規 格- XC 
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用 途-1文字表示する。 

書式- #include < sys / iocs . h > 

int _ iocs _ b_putc ^mt code ); 

解 説—— _ i 0 CS _ b _ P iit C 関数は⑺みで指定した 1 文字 （1 バイト）を表示する。 

_ iocs _ b _ putc 関数は IOCS コール 0 x 20 を発行することによって処理される。 

戻り値一上位16ビットに表示後の カーソル 位置の X 座標を返し，下位16ビットに Y 座 
標を返す。 

規 格 — XC 
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—iocs —b putmes 


用 途—表示位置を指定して文字列を表示する。 

僅 式- # include < svs / iocs . h > 

int _ iocs _ b_putmes (mt color , mt x , int y , 

int max , const char * message ); 

解 説- _ iocs _ b_putmes 関数は，ズと少で指定した座標からで指定した属性で， 

message で指定した文字列を表示する。 

表示される文字列が w 似で指定した文字数よりも長い場合でも， mac で指定し 
た文字数以上は表示されないが，このとき表示が漢字の前半で打ち切られる場合 
はその全角文字は表示されず， スペースに 置換される。逆に，表示される文字列 
が wax で指定した値よりも短い場合，残りは スペースが 表示される。 

_ iocs _ b_putmes 関数は本来ファンクシヨン行の表示を行うためのものなので， 
- iocs - b—consol 関数による表示範囲指定の影響は受けない。また，表示後のカー 
ソル位置も変化しない。 

color に指定できる値は次のとおり。 


• 〇 黒 

• 1 水色 
•2 黄色 
•3 白 
•4 黒 
•5 水色の強調 

•6 黄色の強調 

•7 白の強調 

• 8 黒 

•9 水色のリバース 
•10 黄色のリバース 
•11 白のリバース 
• 12 黒 

•13 水色の強調，リバース 
•14 黄色の強調，リバース 
•15 白の強調，リバース 
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V ,少にはそれぞれ表示位置を絶対座標で指定し， m の C には表示文字数一1をバイ 
卜単位（半角文字単位）で指定する。また， maw ? 供には表示する文字列を指定す 
る。ただし，この文字列は null 文字で終了していること。 
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_ iocs _ b _ putmes 関数は IOCS コール 0 x 2 F を発行することによって処理される 0 
戻り値一次の X 座標を返す。 

規 格 — XC 

関連項目- _ iocs _ b—console 
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」ocs b read 


用 途—ディスクの読み込みを行う。 

書 式-# include < sys/iocs . h > 

mt _ iocs _ D_read (int drive , 

int recno , int len , void * addr ); 

解 説一 . iocs.bjread 関数は， drive で指定したドライブの recno で指定したレコードか 

ら，/⑼で指定したバイト数を読み込み，結果をふかで指定した領域に格納する。 

ゴ r / ve と/^については- iocs _ b _ seek 関数を参照のこと。また，/⑽については 
_ iocs _ b — verify 関数を参照のこと。 

a ゴみには読み込みバッファの先頭アドレスを指定するが，このアドレスにはスー 
パー バイザ領域も指定できるので注意すること。 

_ iocs_bjread 関数は IOCS コール 0 x 46 を発行することによって処理される。 

戻り値——成功した場合は， FDC のステータス 情報 （負の 値もあり 得る） を返し，失敗した 
場合は OxFFFFFF ?? を返す。 

フロッピーディスクの 場合，読み込みに失敗しても エラー 終了とはならず， FDC 
のステータス 情報として エラーが 発生したことを返す。返される FDC のステー 
タス情報については， _ iocs _ b — verify 関数を参照のこと。 

規 格— XC 

関連項目- _ iocs _ b _ seek ，_ iocs _ b_verify 
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—iocs_d— readdi 


用 途——フロッピーデイスクの診断のための読み込みを行う。 

書式- #mclude < sys/iocs . h > 

int _ iocs _ b_readdi (int drive , 

int recno , int len , void ホ addr ); 



解 説- _ iocs _ b _ readdi 関数は，ゴ r / ve で指定したドライブので指定したレコード 

からのデータを， h で指定したバイト数を診断のために読み込み， 結果を addr 
で指定した領域に格納する。 

drive ヒ recm ? については- iocs _ b _ seek 関数を参照のこと。 

/⑼には1024の倍数を指定し， a ゴみには読み込みバッファの先頭アドレスを指定 
する。ただし，このアドレスにはスーパーバイザ領域も指定できるので注意する 
こと0 

_ iocs _ b _ readdi 関数は IOCS コール 0 x 42 を発行することによって处;理される。 


戻り値一成功した場合は， FDC のステータス情報（負の値もあり得る）を返し，失敗した 
場合は OxFFFFFF ?? を返す。 

読み込みに失敗してもエラー終了とはならず，必ず指定バイト数の読み込みを行 
う。返される FDC のステータス情報については， _ iocs _ b _ verify 関数を参照の 
こと。 


規 格 — XC 

関連項目- _ iocs _ b _ seek ， _ iocs _ b_verify 
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—iocs_b_readdi 


用 途—— フロッ ピーディスクの削除データを読み込む。 

書 式- # include < sys/iocs . h > 

int _ iocs _ b_readdl (int drive , 

int recno , int len , void * addr ); 

解 説- _ iocs _ b _ readdl 関数は，ゴ r / ve で指定したドライブの作⑺〇で指定したレコード 

から，/⑼で指定したバイト数の削除データを読み込み，結果を似/みで指定した 
領域に格納する。 

ゴ r / ve と rec /20 については- iocs _ b _ seek 関数を参照のこと。また，については 
_ iocs _ b _ verify 関数を参照のこと。 

a ゴみには読み込み バッファの 先頭アドレスを指定するが，このアドレスにはスー 
パー バイ ザ領域も指定できる ので 注意すること。 

_ iocs _ b _ readdl 関数は IOCS コール 0 x 4 C を発行することによって処理される。 

戻り値一成功した場合は， FDC のステータス情報（負の値もあり得る）を返し，失敗した 
場合は OxFFFFFF ?? を返す。 

フロッピーディスクの 場合，読み込みに失敗しても エラー 終了とはならず， FDC 
のステータス 情報として エラーが 発生したことを返す。返される FDC のステー 
タス 情報については， - iocs _ b _ verify 関数を參照のこと。 

規 格 — XC 

関埋項目- _ iocs _ b _ seek , _ iocs _ b_verify 
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—iocs b—readid 


用 途 ——フロッピーディスクの ID データを読み込む。 

1 ¢- frinc 丄 ude < sys / iocs . li > 

int _ iocs _ b_readid (mt drive , mt recno , void * addr ); 

解 説 - _ iocs _ b _ readid 関数は， め */ ve で指定したドライブの/*汉720で指定したレコード 

から， ID データを読み込み，結果を a ゴめ ■で指定した領域に格納する。 drive と 
recno については- iocs _ b_seek 関数を参照、のこと。 

a ゴみには読み込みバッファの先頭アドレスを指定するが，このアドレスにはスー 
パーバイザ領域も指定できるので注意すること。 

_ iocs _ b_readid 関数は IOCS コール 0 x 4 A を発行することによって処理される。 

戻り値 ——成功した場合は， FDC のステータス情報（負の値もあり得る）を返し，失敗した 
場合は OxFFFFFF ?? を返す。 

フロッピーディスクの 場合，読み込みに失敗しても エラー 終了とはならず ， FDC 
のステータス 情報として エラーが 発生したことを返す。返される FDC のステー 
タス情報については， _ iocs _ b _ verify 関数を参照のこと。 

規 格 - XC 



関連項目- _ iocs _ b_readdl 
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ライブラリー第 2 部 


iocs_b recall 


用 途——トラック〇へシークする。 

式- # include < sys / iocs . h > 

int _ iocs _ b_recali (int drive ); 

解 説- _ iocs _ b _ recali 関数は，ゴ r / ve で指定したドライブのへッドを0トラックへシー 

クさせる。 

ゴ r/vH こは/?ゴ ax 256を指定する。ただし，フロッピーディスクの場合， drive に 
/^ ax 256+255 を指定すると，強制レディ状態での調査を行う。 p ぬについては 
_ iocs _ b _ seek 関数を参照のこと。 

_ iocs _ b _ recali 関数は IOCS コール 0 x 47 を発行することによって处理される。 

戻り値一成功した場合は， FDC のステータス 情報 （負の 値もあり得る）を返し，失敗した 
場合は OxFFFFFF ?? を返す。 

フロッピーディスクの場合，シークに失敗してもエラー終了とはならず， FDC の 
ステータス情報としてエラーが発生したことを返す。返される FDC のステータ 
ス情報については， -. iocs _ b _ seek 関数を参照のこと。 

また，フロッピーディスクに対して強制レディ状態で調査を行った場合は，指定 
ドライブが存在するかどうかをチヱックすることができる。この場合，戻り値の 
リザルトステータス0のビット4( EQUIPMENT CHECK ) が1であれば，指定した 
ドライブが存在しないことを示す。 

規 格- XC 

関連項目- _ iocs _ b_seek 
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—iocs b right 


用 途——カーソル位置を指定桁数だけ右へ移動する。 



書式- frinc 丄 ude < sys / iocs . h > 

void _ iocs _ b_right (int cnt ); 

解 説- - iocs _ b _ right 関数はカーソル位置をじ咐桁右へ移動する。カーソル位置が右端 

を越える場合でも，左スクロールは行われない。なお， c がに0を指定すると1と 
みなされる。 

_ iocs . b _ right 関数は IOCS コール 0 x 28 を発行することによって処理される。 
戻り値——なし。 


規 格 —— XC 
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ライブラリー第 2 部 


iocs_bseek 


用 途—指定トラックまで シークす る。 

書エ C - # include < sys/iocs . h > 

int _ iocs _ b_seek (int drive , int recno ); 

解 説- _ iocs _ b _ seek 関数はめ*/ ve で指定したドライブのへッドを，/*汉 720 で指定したレ 

コードのトラックまでシークさせる。 

drive には pda x 256 +/如みを指定する。/?ゴ a の内容は次のとおり。 

• 0 x 80 〜 0 x 8 F ハードディスク 

• 0 x 90 〜 0 x 93 フロッピーディスク 

ハードディスクの場合は，に256バイト単位のレコード番号を指定する。 
フロッピーディスクの場合は， ac / K ? にセクタ長，トラック，サイド，セクタの順 
に上位から8ビットずつ指定する。 

セクタ長の指定は次のとおり。 


• 0 128バイト 

•1 256バイト 

• 2 512バイト 

• 3 1024バイト 

みの指定はハードディスクの場合は〇を指定するが，フロッピーディスクの 
場合は次のようなビットフイールドを設定する。 


0 

fm/mfm 

retry 

seek 

0 

0 

0 

0 


たとえば， fm / mfm ビットは0で FM (単密度)，1で MFM (倍密度）を意味し， 
retry ビットは〇でリトライしない：•ことを，1でリトライすることを意味する。 
また，從ビットは0でシークしないで実行することを，1でシークして実行す 
ることを意味する。 

故ぴで1が指定された場合は10回リトライを行い，最初の5回はシークなしの 
リトライ，残り5回はシークあり（リキャリブレートシーク）のリトライを行う。 

_ iocs _ b _ seek 関数は IOCS コール 0 x 40 を発行することによって処理される。 
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戻り値——成功した場合，ハードディスクならば〇を含む正の値を，フロッピーディスクな 
らば FDC のステータス 情報（負の値もあり得る）を返す。また，失敗した場合は 
OxFFFFFF ?? を返す。 

フロッピーディスクの場合，シークに失敗してもエラー終了とはならず ， FDC の 
ステータス情報として失敗したことを返す。 



FDC のステータス情報は次のとおり。 

• ビツト31〜24 リザルトステータス0 
•ビット23〜16 コマンド終了時のシリンダ番号 
•ビット15〜〇 不定 

リザルトステータス0の内容は次のとおり。 


ビット7, 6 

割り込み発生要因 

00.•.コマンド正常終了 

01•..コマンド異常終了 

10.. . 無効なコマンド 

11.. . ドライブ状態の変化 

ビット5 

シーク 動作時に セット 

ビット4 

Fault 信号を受けた場合などにセット 

ビット3 

Ready 状態でないときにセット 

ビット2 

割り込み発生時のへッドの状態 

ビット1, 0 

割り込み発生時のドライブ番号 

00... ドライブ0 

01... ドライブ1 

10.. . ドライブ2 

11.. . ドライブ3 


規 格 — XC 
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ライブラリー第 2 部 


_iocs_b_sftsns 


用 途ーシフトキーの押下げ状態を検査する。 

邊式- #mclude < sys/iocs . h > 

int _ iocs _ b_sftsns ( void ); 

解 説—— _ iocs _ b.sftsns 関数はシフトキーの押下げ状態を調べる。 

_ iocs _ b_sftsns 関数は IOCS コール 0 x 02 を発行することによって处理される。 

戻り値——戻り値の下位15ビットには各シフトキーの押下げ状態が返されるが， LED のつ 
いているキーについては LED の点灯状態を返す。戻り値の下位15ビットの内容 
は次のとおり。いずれも該当ビットが1の場合に押下されていることを示す。 


15 

14 

13 

12 

11 

10 

未定義 

全角 

ひらがな 

INS 

CAPS 

コード入力 

9 

8 

7 

6 

5 

4 

口ーマ字 

かな 

CAPS 

コード入力 

口ーマ字 

かな 


3 

2 

1 

0 

OPT .2 

OPT .1 

CTRL 

SHIFT 


規 格 — XC 
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一 iocs _b—super 


用 途ースーパーバイザモードとユーザモードとを切り替える。 

書 式- #include < sys/iocs . h > 

mt _ iocs _ b_super (mt ssp ); 

解 説- _ iocs _ b _ super 関数はスーパーバイザモードとユーザモードとの切り替えを行う。 

思/?が0の場合はユーザ モー ドからスーパーバイザ モー ドへ，0以外の場合はスー 
パーバイザ モー ドからユーザ モー ドへ切り替える。 

_ iocs _ b _ super 関数は IOCS コール 0 x 81 を発行することによって処理される。 

戻り値——切り替える前の ssp を返す。ただし，スーパーバイザモードのときに再度スー 
パーバイザモードに切り替えた場合はエラーとなり，負の値を返す。 

規 格一 XC 






ライブラリー第 2 部 


一 iocs_b 


用 途—カーソル位置を指定行数だけ上へ移動する。 

^ xi - # include < svs / iocs . h > 

void _ iocs _ b-.up unt cnt ); 

解 説—— _ ioc S _ b _ Up 関数はカーソル位置を c / zr 行上へ移動する。カーソル位置が先頭行を 
越える場合でも，スクロールダウンは行われない。なお，£72バこ〇を指定すると1 
とみなされる。 

_ iocs _ b _ up 関数は IOCS コール 0 x 26 を発行することによって処理される。 

戻り値——なし。 

規 格 — XC 
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_iocs_ 



用 途—カーソル位置を1行上へ移動する。 

書 式- #include く sys / iocs . h > 

void _ iocs _ b _ up_s ( void ); 

解 説—— - iocs _ b _ Up _ s 関数は カーソル 位置を1行上へ移動する。ただし，現在の カーソル 

位置が先頭行だった場合はスクロールダウンが行われる。 

_ iocs _ b _ up . s 関数は IOCS コール 0 x 25 を発行することによって処理される。 
戻り値——なし。 

規 格- XC 
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—iocsJbverify 


用 途— データの 比較を行う。 

書式- #mclude < sys/iocs . h > 

int _ iocs _ b_verify unt drive , int recno , 

int len , const void * addr ); 

解 説- _ iocs _ b _ verify 関数は，ゴ r / ve で指定したドライブの rec / io で指定したレコード 

からのデータを，/⑼で指定したバイト数読み込み，ゴみで指定した領域の内容 
と比較する。 

drive ヒ recno について は- iocs _ b _ seek 関数を参照のこと。 

た/ 7にはハード ディスクの 場合256 の 倍数を， フロッ ピーディ スクの 場合は1024 
の倍数を指定する。 

には比較対象のデータの先頭アドレスを指定するが，このアドレスにはスー 
パーバイザ領域も指定できるので注意すること。 

_ iocs _ b _ verify 関数は IOCS コール 0 x 41 を発行することによって处理される。 

戻り値——成功した場合，ハードディスクならば0を含む正の値を，フロッピーディスクな 
らば FDC のステータス情報（負の値もあり得る）を返す。また，失敗した場合は 
OxFFFFFF ?? を返す。 

フロッピーディスクの 場合，比較に失敗しても エラー 終了とはならず ， FDC のス 
テータス情報として失敗したことを返す。 

FDC の ステータス 情報は次のとおり。 


•ビット 31〜24 
•ビット 23〜16 
•ビット 15〜8 
•ビット7〜〇 


リ ザルト ステータス0 
リザルト ステータス1 
リザル ト ステータス 2 
シリンダ番号 
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リザルトステータス〇の内容は次のとおり。 


ビット7，6 

割り込み発生要因 

00... コマンド正常終了 

01... コマンド異常終了 

10.. . 無効なコマンド 

11.. . ドライブ状態の変化 

ビット5 

シーク動作時にセット 

ビット4 

Fault 信号を受けた場合などにセット 

ビット3 

Ready 状態でないときにセット 

ビット2 

割り込み発生時のへッドの状態 

ビット1，0 

割り込み発生時のドライブ番号 

00... ドライブ0 

01... ドライブ1 

10.. . ドライブ2 

11.. . ドライブ3 



リザルト ステータス1 の内容は次のとおり。 


ビット7 

最終セクタを越えてアクセスした場合にセッ 

卜 

ビット6 

つねに0 

ビット5 

ID または CRC エラーのときにセット 

ビット4 

MPU または DMA が， FDC に対して規定時 

間内にデータの入出力ができなかった場合に 

セット 

ビット3 

つねに0 

ビット2 

セクタが見つからない場合にセット 

ビット1 

書き込み時にライトプロテクトがかかってい 

た場合にセット 

ビット0 

セクタが存在しない，あるいはマークのみで 

データフイールドがない場合にセット 
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リザルトステータス2の内容は次のとおり。 


ビット7 

つねに0 

ビット6 

削除データ読み込み時に通常データを読んだ 

場合，またはその逆の場合にセット 

ビット5 

CRC エラーのときにセット 

ビット4 

指定したトラックが見つからない場合にセッ 
卜。このビットがセットされ，リザルトステー 

タス1のビット2もセットされる場合は，卜 

ラックが見つからなかったことを示す 

ビット3 

ベリファイでデータが一致した場合にセット 

ビット2 

ベリファイでデータが一致しなかった場合に 

セット 

ビット1 

指定したトラック番号が規定外の場合にセッ 

卜 

ビット0 

マークのみでデータフイールドがなかったた 
めに，リザルトステータス1のビット0が 

セットされた場合にセット 


規 格 — XC 

関連項目- _ iocs _ b_seek 
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—iocsb—wpeek 


用 途ーメモリから1ワードデータ読み込む。 



書式- #include <sys/iocs.h> 

int _iocs_b_wpeek (unsigned short *addr ノ； 

解 説- _iocs_b_wpeek 関数は， 0 ゴゴ /* で指定したアドレスから 1 ワードデータ読み込む。 

主に ユーザ モードでス ー パーバイザエリアをアクセスするために使用する。ただ 
し， X68000 ではゴみでネ旨定するアドレスは偶数アドレスでなければならない。 

_iocs_b_wpeek 関数は IOCS コール 0x83 を発行することによつて处理される。 
戻り値——読み込んだワードデータを返す。 

規 格 — XC 
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—iocsb—wpoke 


用 途—メモリに1ワードデータ書き込む。 

# xi - # include < svs/iocs . h > 

void 一 10 cs _ b_wpoke (void 本 addr , int data ); 

解 説- _ iocs _ b_wpoke 関数は，ゴゴ r で指定したアドレスへぬ fa で指定した1ワードデー 

夕を書き込む。主にユーザモードでスーパーバイザエリアをアクセスするために 
使用する。ただし， X 68000 ではめ•で指定するアドレスは偶数アドレスでな 
ければならない。 

_ iocs _ b_wpoke 関数は IOCS コール 0 x 87 を発行することによつて処理される。 

戻り値-なし。 

規 格—— XC 
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iocs 一 



用 途ーディスクにデータを書き込む。 

書式- #include く svs / iocs . h > 

int _ iocs _ b_write (int drive,int recno , 

int len , const void * addr ); 

解 説- _ iocs _ b _ write 関数は，ゴゴ/•で指定した領域のデータを/⑼で指定したバイト数 

だけ， drive で指定したドライブの recno で指定したレコードから書き込む。 

drive と については- iocs _ b _ seek 関数を参照のこと。また，/⑼については 
_ iocs _ b _ verify 関数を参照のこと。 

如^かには書き込みデータの先頭アドレスを指定するが，このアドレスにはスー 
パーバイザ 領域も指定できるので注意すること。 

_ iocs _ b _ write 閨数は IOCS コール 0 x 45 を発行することによって处理される。 

戻り値——成功した場合は， FDC のステータス 情報 （負の 値もあり得る）を返し，失敗した 
場合は OxFFFFFF ?? を返す。 

フロッピーディスクの場合，書き込みに失敗しても エラー 終了とはならず， FDC 
のステータス 情報として エラーが 発生したことを返す。返される FDC の ステ ー 
タス情報については， _ iocs _ b _ verify 関数を参照のこと。 

注 意- _ iocs _ b _ write 関数は， Human 68 k のバッファリング处理とは無関係にディ 

スクに対して書き込みを行う。したがって不用意な書き込みは，ディスクと 
Human 68 k のバ ッファデータと の 整合性を損ねる ので 注意すること。 

規 格 — XC 

関連項目- _ iocs _ b _ seek , _ iocs _ b—verify 
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—iocs_b writed 


用 途——フロッピーディスクへ削除データを書き込む。 

書式- #include < sys / iocs . h > 

mt _ iocs _ b_writed (int drive , int recno , 

int len , const void * addr ); 

解 説- _ iocs _ b _ writed 関数はフロッピーディスクに対して削除データを書き込む。 

drive ， recno ， len ， 0 ゴゴ /* の各引数については， _ iocs _ b _ write 関数を参照のこと。 
_ iocs _ b _ writed 関数は IOCS コール 0 x 49 を発行することによって処理される。 

戻り値——成功した場合は， FDC のステータス情報（負の値もあり得る）を返し，失敗した 
場合は OxFFFFFF ?? を返す。 

フロッピーディスクの場合，書き込みに失敗してもエラー終了とはならず， FDC 
のステータス情報としてエラーが発生したことを返す。返される FDC のステー 
タス情報については， _ iocs _ b _ verify 関数を参照のこと。 

規 格 — XC 

関連 r 貝白- _ iocs _ b _ verify , _ iocs _ b_write 
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Jocsbgctrlgt 


用 途ーバックグラウンドコントロールレジスタを読み込む。 

書 式一# include < sys / iocs . n > 

int _ iocs_bgctrlgt (mt mode ); 

解 説- - iocs_bgctrlgt 関数は，バックグラウンド ( BG ) コントロールレジスタの読み込 

みを行う。 wo みには BG コントロールレジスタ （0 〜 1) の番号を指定する。 

_ iocs_bgctrlgt 関数は IOCS コール OxCB を発行することによって処理される。 

戻り値一成功した場合はテキストページ X 2+ 表示モード （0 〜 1) を返し，失敗した場合は 
次の値を返す。 

•-1 画面モードエラー（画面サイズが768 X 512のときなど） 



規 格- XC 
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iocs bqctrlst 


用 途—バックグラウンドコントロールレジスタを設定する。 

晋ェ t - frinc 丄 ude < sys / iocs . h > 

int _ iocs_bgctrlst unt mode , int page , mt onoff ); 

解 説- _ iocs _ bgctrlst 関数は，バックグラウンド （ BG ) コントロールレジスタの設定を 

行う。 / wo みには BG コントロールレジスタ （0 〜 1) の番号を指定する。 

page にはテキス トページ （0 〜 1) を指定し，洲〇ガには表示のオン/オフを指定す 
る。表示をオンにするには1を，オフにするには0を指定すること。ただし， 一 1 
が指定された場合は設定を変更せずに，現在の設定を使用する。 

_ iocs _ bgctrlst 関数は IOCS コール OxCA を発行することによって処理される。 
戻り値一成功した場合は0を返し，失敗した場合は次の値を返す。 

•一1画面モードエラー（画面サイズが768 X 512のときなど） 

規 格 — XC 
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—locsbgscrlgt 


用 途—— バック グラウンドス クロール レジスタを読み込む。 

書 式- #include く sys/iocs 上> 

int _ iocs_bgscrlgt (int mode , int * x , int * y ); 

解 説—— _ iocs_bgscrlgt 関数はバックグラウンドスクロールレジスタの読み込みを行う。 

mode にはスクロ ールレジスタの番号を指定する。 

X ,少にはそれぞれ X 座標， Y 座標を格納する領域のポインタを指定する。返さ 
れる値は〇〜1023の範囲である。 

_ iocs_bgscrlgt 関数は IOCS コール 0 xC 9 を発行することによつて处理される。 

戻り値一成功した場合は0を返し，； c ， 少で指定したポインタに X 座標， Y 座標が格納さ 
れる。失敗した場合は次の値を返す。 

•-1 画面モードエラー（画面サイズが768 X 512のときなど） 

規 格— XC 
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-■ocsJbqscrlst 


用 途——バックグラウンドスクロールレジスタを設定する。 

_ 式- frinc 丄 ude < sys / iocs . h > 

int _ iocs_bgscrlst unt mode , int x , int y ); 

解 説- _ iocs _ bgscrlst 関数はバックグラウンド （ BG ) スクロールレジスタの設定を行う。 

mode に は次の値を指定する。 


ビット31 

0 ... 垂直帰線期間を検出してから設定する 

1 ... 垂直帰線期間を検出しないで設定する 

ビット0 

0 ... BG 0を設定する 

1 ... BG 1を設定する 


X 、 夕にはそれぞれ X 座標， Y 座標を〇〜1023の範囲で指定するが，いずれも 
_1が指定された場合は，設定を変更せずに現在の設定を使用する。 

_ iocs _ bgscrlst 関数は IOCS コール 0 xC 8 を発行することによって処理される。 
戻り値——成功した場合は0を返し，失敗した場合は次の値を返す。 

•-1 画面モードエラー（画面サイズが768 X 512のときなど） 

規 格- XC 
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」 ocs_bgtextcl 


用 途——バックグラウンドテキストをクリアする。 



書 式- #include < svs/iocs . h > 

int _ iocs_bgtextcl (int page , int code ); 

解 説一 _ iocs _ bgtextcl 関数はバックグラウンド ( BG ) テキストのクリアを行う 0 

坪にはクリァするテキストページ （0 〜 1) を指定し，⑺ぬにはパターンコード 
を指定す る。 このパターンコードの値は 次のとおり。 


ビット 15 

0 ... 縦方向反転しない 

1 ... 縦方向反転する 

ビット 14 

0 ... 横方向反転しない 

1 ...横方向反転する 

ビット8〜11 

パレットブロック （0 〜 15) 

ビット〇〜 7 

PCG コード （0 〜 255) 

上記以外 

つねに0 


たとえば code に 0 x 873 C を指定した場合， PCG コードは60，パレットブロック 
は7,縦方向のみ反転となる。 

_ iocs . bgtextcl 関数は IOCS コール OxCC を発行することによって処理される。 
戻り値——成功した場合は0を返し，失敗した場合は次の値を返す。 

•一1画面モードエラー（画面サイズが768 X 512のときなど） 


規 格 —— XC 
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—locsbcitextat 


用 途—バックグラウンドテキストを読み込む。 


# xi - #mclude < sys/iocs . h > 

int _ iocs 一 bgtextgt (int page , int x , int v ); 


解 説- _ iocs _ bgtextgt 関数はバックグラウンドテキストの読み込みを行う。 

ぎ e にはテキスト ページ （0 〜 1) を指定し，； c , 少にはそれぞれテキスト X 座標， 
テキスト Y 座標を〇〜63の範囲で指定する。 

_ iocs _ bgtextgt 関数は IOCS コール OxCE を発行することによって処理される。 


戻り値——成功した場合はパターンコードを返し，失敗した場合は次の値を返す0パターン 
コードについては， _ iocs _ bgtextcl 関数を参照のこと。 

•—1 画面モード エラー （画面サイズが768 X 512のときなど） 


規 格 — XC 

関連項目- _ iocs_bgtextcl 
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_iocs_bqtextst 


用 途ーバックグラウンドテキストを設定する。 

書 式- #include < sys / iocs . h > 

int _ iocs_bgtextst (int page , int x , int y , mt code ); 

解 説- _ iocs _ bgtextst 関数はバツクグラウンドテキストの設定を行う。 

にはテキストページ （0 〜 1) を指定し，； C , 夕にはそれぞれテキスト X 座標, 
テキスト Y 座標を〇〜 6 3の範囲で指定する。 

code には パターンコー ドを指定する。 パターン コードの内容は- iocs_bgtextcl 
関数を参照のこと。 

_ iocs _ bgtextst 関数は10 CS コール OxCD を発行することによって処理される。 
戻り値——成功した場合は0を返し，失敗した場合は次の値を返す。 

•一1画面モードエラー（画面サイズが768 X 512のときなど） 

規 格 — XC 

関連項目- _ iocs_bgtextcl 
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Jocsbindatebcd 


用 途——2進数の日付を内部時計にセットできる形式に変換する。 

書式-# include < sys/iocs . h > 

int _ iocs_bindatebcd (int date ；; 

解 説- _ iocs _ bindatebcd 関数は，ゐ化で指定した2進数形式の日付データを， 

_ iocs _ bindateset 関数で使用できる BCD 形式に変換する。 

date に指定するビットフイールドの値は次のとおり。 

OOOOyvyy yyvyyyvy mmmmmmmm dddaddad 


• dddddddd 

• mmrnTnmTnmrn 

• yyyyyyyyyyyy 


日 （01 〜 31) 

月 （01 〜 12) 

年(1980〜2079) 


_ iocs _ bindatebcd 関数は IOCS コール 0 x 50 を発行することによって処理される。 

戻り値——成功した場合は次のようなビットフィールドを返し，失敗した場合は一1を返す。 
年/月/日はいずれも BCD 2 桁である。 


UUUUWWWW YYYYYYYY MMMMMMMM DDDDDDDD 


• DDDDDDDD 

• MMMMMMMM 

• YYYYYYYY 

• wwww 


日 （01 〜 31) 

月 （01 〜 12) 

年 （00 〜99，1980年からの相対年数) 
曜日カウンタ （0 〜6，0で日曜日） 
閏年カウンタ （0 〜 3) 


規 格 — XC 

関連項目- _ iocs_bindateset 
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用 途——内部時計から日付を読み込む。 

書式- #include < sys / iocs . h > 

int _ iocs_bindateget ( void ); 

解 説- _ iocs _ bindateget 関数は，内部時計から現在の日付を読み込む。 

_ iocs _ bindateget 関数は IOCS コール 0 x 54 を発行することによって処理される 0 

戻り値——次のようなビットフィールドを返す。年/月/日はいずれも BCD 2 桁である。 


0000 WWWW YYYYYYYY MMMMMMMM DDDDDDDD 


• WWWW 


• DDDDDDDD 


• MMMMMMMM 


• YYYYYYYY 


日 （01 〜 31) 

月 （01 〜 12) 

年 （00 〜99，1980年からの相対年数) 
曜日 （0 〜6，0で日曜日） 


規 格 — XC 
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locsbindateset 


用 途——内部時計に日付を設定する。 

書 式- #include < sys / iocs . h > 

void _ iocs_bindateset unt aate ); 

解 説一 _ iocs _ bindateset 関数はぬかで指定した BCD の日付を内部時計に設定する。 
ゴ afe の内容については- iocs _ bindatebcd 関数の戻り値を参照のこと。 

_ iocs _ bindateset 関数は IOCS コール 0 x 51 を発行することによって处理される 0 
戻り値一なし。 

規 格 —— XC 

関連項目- _ iocs_bindatebcd 
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iocs bitsns 


用 途一指定キーの押下げ状態を検査する。 



書 式- #include < sys / iocs . h > 

int _ iocs_bitsns (int group ); 

解 説- _ iocs_bitsns 関数は grow /7 で指定したキーコードグループの押下げ状態を調 

ベる0 

キーコードグループは 次のとおり。縦軸が キーコードグルーブ， 横軸が ビット 位 
置を表す。 



0 

1 

2 

3 

4 

5 

6 

7 

0 

未定義 

ESC 

1 ! 

2 " 

3 # 

4 $ 

5 

6 & 

1 

7 , 

8 ( 

9 ) 

0 

- = 

為 

\ 1 

BS 

2 

TAB 

Q 

W 

E 

R 

T 

Y 

U 

3 

I 

0 

P 

0 

[ 

CR 

A 

S 

4 

D 

F 

G 

H 

J 

K 

L 

» 

5 


] 

Z 

X 

C 

V 

B 

N 

6 

M 

, < 

. > 

/ ? 

嫌 

SPC 

HOME 

DEL 

7 

ROLLUP 

R0LLDN 

UNDO 

<— 

t 

—— ► 

1 

CLR 

8 

/ 

本 

- 

7 

8 

9 

+ 

4 

9 

5 

6 


1 

2 

3 

ENTER 

0 

A 

9 


記号 

登録 

HELP 

XF1 

XF2 

XF3 

B 

XF4 

XF5 

かな 

□—マ 

コ ード 

CAPS 

INS 

ひら 

C 

全角 

BREAK 

COPY 

F1 

F2 

F3 

F4 

F5 

D 

F6 

F7 

F8 

F9 

F10 

未定義 

未定義 

未定義 

E 

SHIFT 

CTRL 

0PT.1 

OPT. 2 

未定義 

未定義 

未定義 

未定義 

F 

未定義 

未定義 

未定義 

未定義 

未定義 

未定義 

未定義 

未定義 


_ iocs_bitsns 関数は IOCS コール 0 x 04 を発行することによって処理される 0 


戻り値——指定したキーコードグループの押下げ状態を返す。該当ビットが1ならば，その 
キーが押されていることを示している。 

規 格 — XC 
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ライブラリー第 2 部 


—iocs—bootmf 


用 途——パワー ON 情報とシステムのブート情報を返す。 

-rf xt - frmc 丄 ude < sys/iocs . h > 

mt _ iocs _ b 00 tinf ( void ); 

解 説—— — iocs-bootinf 関数はパワー ON 情報とシステムのブート情報を返す。 

_ iocs_bootinf 関数は IOCS コール 0 x 8 E を発行することによって処理される。 

戻り値ーブート情報を返す。ブート情報の内容は次のとおり。 


ビット 31 〜 24 

パワー ON 情報 

0x00 …パワースイッチにより起動 

0x01 …外部スイッチにより起動 

0x02 …タイマにより起動 

ビット 23 〜〇 

システムのブート情報 

0x000080 〜 0x00008f 

ハードディスクから起動 

(下位 4 ビットがブートしたドライブ番号） 

0x000090 〜 0x000093 

フロッピーディスクから起動 

(下位2ビットがブートしたドライブ番号） 

OxEDOOOO 〜 0XED3FFF 

S - RAM からブートしたときのブートアドレス 

上記以外の値 

ROM からブートしたときのブートアドレス 


規 格 — XC 
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—iocs—box 


用 途——グラフィック画面にボックスを描画する。 



書 式- #include < sys / iocs . h > 

int _ iocs 一 box (.const struct _boxptr * ptr ); 


解 説一 _ iocs_box 関数はグラフィック画面にボックスを描画する。ひに指定する- boxptr 

構造体は次のとおり。 


struct _boxptr { 


short xi ; 
short yl ; 
short x 2; 
short y 2; 

unsigned short color ; 


/* 始点座標の X */ 

/* 始点座標の Y */ 

/* 終点座標の X */ 

/* 終点座標の Y */ 

/* パレツトコード*/ 


unsigned short linestyle ; /* ラインスタイル*/ 


>； 


_ iocs_box 関数は IOCS コール 0 xB 9 を発行することによって処理される。 


戻り値——成功した場合は〇を返し，失敗した場合は次の値を返す。 
•一1グラフィックは使用できない 


規 格 — XC 
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ライブラリー第 2 部 



用 

書 

解 


途——グラフィック画面に円を描画する。 

xt - frinciude < sys/iocs . h > 

int _ iocs_circle (const struct _circleptr * ptr ); 

説- - iocs_circle 関数はグラフィック画面に円を描画する。 〆 /*で指定する .circleptr 

構造体は次のとおり。 

struct _circleptr { 


/* 中心の X 座標*/ 
/* 中心の Y 座標*/ 


short x ; 
short y ; 


unsigned short radius ; /* 半径 */ 
unsigned short color ; /* ハレットコード */ 


/* 円弧開始角度*/ 
/* 円弧終了角度*/ 


short start ; 
short end ; 


unsigned short ratio ; /* 上匕 ¥ */ 

>； 

円弧開始角度/円弧終了角度は〇〜 360 の値を指定する。ただし，範囲外の角度 
を指定した場合は360を指定したとみなされる。また，角度に負の値を指定する 
と円弧のかわりに扇型を描画する。このとき角度の指定は絶対値を取られる。 

比率は〇〜65535までの値を指定する。比率が◦〜255のとき，半径は横方向 
の半径を意味し，縦方向との比率は X : 256となる。また，比率が256〜65535 
のとき，半径は縦方向の半径を意味し，横方向との比率は X : 256となる。 

_ iocs_circle 関数は IOCS コール OxBB を発行することによって処理される。 

値——成功した場合は0を返し，失敗した場合は次の値を返す。 

•—1 グラフィックは使用できない 


用 

書 

解 


規 格 — XC 
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Chapter 3 — IOCS コールライブラリ 



用 途——テキスト画面にパターンを書き出す（クリツビング処理つき）。 

書 式- #include < sys / iocs . h > 

void _ iocs_clipput (int x , int y , const struct _fntbuf * buff , 
const struct _clipxy * clipptr ); 


解 説—— - iocs - clipput 関数は； c および少で指定したテキスト画面の座標へ，ガで指定 


したパターンデータを書き込むが，このときびの内容によってクリ ッ ピン 
グ処理を行う。 

ゐげにはスーパーバイザ空間も指定できるので，誤ったアドレスを指定してはな 
らない。また，ゐげに指定する _ fntbuf 構造体には書き込む X 方向， Y 方向の 
ドット数を short で指定する。ガに指定する _ fntbuf 構造体は次のとおり。 


struct _fntbuf i 
short xl; 
short yl; 


/* 処理する X 方向のドット数*/ 
/* 処理する Y 方向のドット数*/ 


unsigned char buffer [72]; /* 読み込みバッファ*/ 

>； 

c / 抑ヶに指定する- clipxy 構造体には，表示領域のクリッビング座標を指定する。 
なお，最終位置を指定するメンバ xe および ye には，指定する座標に1を足した 
値を指定する。 dipptr に指定す る- clipxy 構造体は次のとおり。 

struct _clipxy t 

short xs; /* 表示領域の先頭の X 座標*/ 
short ys; /* 表示領域の先頭の Y 座標*/ 
short xe; /* 表示領域の最終の X 座標*/ 
short ye; /* 表示領域の最終の Y 座標*/ 


_ iocs _ clipput 関数は IOCS コール OxlC を発行することによって处理される。 


戻り値-なし。 

注 意——もし， _ fntbuf 構造体に入らないサイズを指定する場合は，独自に malloc 関数な 


どによって領域を確保してから使用すること。 


規 格 —— XC 


関埋ェ貝白- _ iocs _ textget , _ iocs _ textDut , malloc 
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ライブラリー第 2 部 


—iocs—contrast 


用 途—画面のコントラストを設定する。 

m xi - #mclude < sys / iocs . h > 

mt _ iocs_contrast (int mode ；; 

解 説- _ iocs _ contrast 関数は画面のコントラストを wo みで指定した値に設定する。 

みに〇〜15を指定した場合は，画面をその値の コン トラストに設定するが， 
一1を指定した場合は現在のコントラストを戻り値に設定し， 一 2を指定した場合 
は コントラス トを システム 規定値に設定する。 

_ iocs _ contrast 関数は10 CS コール 0 x 11 を発行することによって处理される。 
戻り値——設定変更前の画面のコントラストを返す。 


規 


格 一一 XC 





Chapter 3—IOCS コールライブラリ 


」 ocs—crtcras 


用 途—— CRTC のラスタ割り込みを設定する。 

書式- #include < sys / iocs . h > 

int _ iocs_crtcras ^const void * addr,int raster ); 



解 説—— - iocs-crtcras 関数は CRTC に設定したラスタ割り込みの処理を設定する 。 addr 

には割り込み処理アドレスを指定するが，0を指定することで割り込みを禁止で 
きる。また，びには割り込みを発生させるラスタを指定する。 

_ iocs_crtcras 関数は IOCS コール 0 x 6 D を発行することによって® i 理される。 


戻り値——割り込みが設定された場合は0を返し，すでに使用している場合は0以外の値を 
返す。 


規 格一 XC 
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ライブラリー第 2 部 


」ocs crtmoa 


用 途—画面モードを設定する。 

谱式- #mclude < svs / iocs . h > 

mt _ iocs_crtmod (int mode ); 

解 説—— _ iocs _ crtmod 関数は wo ゐで指定した画面モードを設定する。 

このとき，テキスト画面は初期状態（画面はクリアされ，パレットは デフォルト） 
となり，グラフィック画面，スプライト，バックグラウンド （ BG ) 画面は無表示 
状態（初期化はされない）となる。 

mo ぬに一1を指定すると，現在の画面モードを返す。 

mo みに 0 x 100 以上の値を指定すると，下位8ビットの画面モードに切り替える 
だけで，画面の初期化（画面のクリア，パレット，コントラスト，表示モードの初 
期化）は行わない。 

mode に指定できる値は次のとおり。 


mode 

周波数 

解像度 

発色数 

VRAM 

0 

31kHz 

512x512 

16/16 

1024 

1 

15kHz 

512x512 

16/16 

1024 

2 

31kHz 

256x256 

16/16 

1024 

3 

15kHz 

256x256 

16/16 

1024 

4 

31kHz 

512x512 

16/16 

512 

5 

15kHz 

512x512 

16/16 

512 

6 

31kHz 

256x256 

16/16 

512 

7 

15kHz 

256x256 

16/16 

512 

8 

31kHz 

512x512 

16/256 

512 

9 

15kHz 

512x512 

16/256 

512 

10 

31kHz 

256x256 

16/256 

512 

11 

15kHz 

256x256 

16/256 

512 

12 

31kHz 

512x512 

16/65536 

512 

13 

15kHz 

512x512 

16/65536 

512 

14 

31kHz 

256x256 

16/65536 

512 

15 

15kHz 

256x256 

16/65536 

512 

16 

31kHz 

768x512 

16/16 

1024 

17 

24kHz 

1024x424 

16/16 

1024 

18 

24kHz 

1024x848 

16/16 

1024 


_ iocs _ crtmod 関数は IOCS コール 0 x 10 を発行することによって処理される。 
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ライブラリー第 2 部 


—locsdakjob 


用 途 一 濁点処理を行う。 

書式 -# include <sys/iocs.h> 

int _iocs_dakjob (char *end); 

解 説- _iocs_dakjob 関数は濁点処理を行う。 

⑼ゴには文字列の終端の null 文字のアドレスを指定する。最後の全角文字に濁点 
処理ができないときは文字列に，を追加するため， null 文字の後に3バイト分 
の領域が必要である。また，。，を追加した場合は^，の後に null 文字を付加す 
るので，文字列の途中を指定すると，の後の文字列が切れてしまう。したがっ 
て，文字列の途中は指定しないこと。 

_iocs_dakjob 関数は IOCS コール 0xA4 を発行することによって処理される。 
戻り値——変換ステータスを返す。変換ステータスは次のとおり。 

• 0 最後の全角文字に濁点処理をした 

• 2 ’を付加した 

規 格 — XC 
関連項目 — _iocs Jianj ob 
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Chapter 3 — IOCS コールライブラリ 


_iocs dateasc 


用 途——日付を表す2進数形式のデータを文字列に変換する。 

書式- #include <sys/iocs .h> 

int _iocs_dateasc (mt date, char *aaar); 

解 説—— _iocs_dateasc 関数は，ぬかで指定した 2 進数形式の日付データを文字列に変換 
し，ゴみで指定した領域へ格納する。 

ぬ纪に指定するビットフイールドの内容は次のとおり。 



FFFFvyyy yyyyyvw mmmmmmmm dddddddd 


• dddddddd 

• TTITTITTITnTTITTITTITn 

• yyyyyyyyyyyy 


日 （01 〜 31) 

月 （01 〜 12) 

年（1980〜2079) 


FFFF には文字列の変換形式を設定する。 


• 0 

1993/06/23 

• 1 

1993-06-23 

• 2 

93/06/23 

• 3 

93-06-23 


0ゴみには文字列を格納するバッファの先頭アドレスを指定するが，このバッファ 
は最低11バイト以上の領域を確保しなければならない。また，このアドレスに 
はスーパーバイザ領域も指定できるので注意すること。 

_iocs_dateasc 関数は10 CS コール 0x5A を発行することによって处理される。 
戻り値一失敗した場合は一1を返す。 

規 格 — XC 
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ライブラリー第 2 部 


一 iocs_datemn 


用 途——日付の形式を BCD から2進数に変換する。 

書 式- #include < sys/iocs . h > 

int _ iocs_datebm (int date ;; 

解 説- _ iocs _ datebin 関数はゴが e で指定した BCD 形式の日付を2進数形式に変換する。 

ぬ纪に指定するビットフィールドの内容は次のとおり。年/月/日はいずれも BCD 2 
桁である。 


0000 WWWW YYYYYYYY MMMMMMMM DDDDDDDD 


• DDDDDDDD 日 （ 01 〜 31) 

• MMMMMMMM 月 （ 01 〜 12) 

• YYYYYYYY 年 （00 〜1980年からの相対年数） 

• WWWW 曜日 （ 0 〜 6, 0 で日曜日） 

_ iocs _ datebin 関数は IOCS コール 0 x 55 を発行することによって処理される。 
戻り値——次のようなビットフィールドを返す。 


wwwwyyvy vyyvyyvy mmrmnniTnTnTn dadddddd 


• dddddddd 日 （01 〜 31) 

• mmmmmmmm 月 （ 01 へ * 12) 

• yyyyyyyyyyyy 年（1980〜207 9) 


• WWWW 


曜日 （ 0 〜 6, 0 で日曜日） 


規 格 — XC 
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Chapter 3 — IOCS コールライブラリ 


—iocsdatecnv 


用 途一一日付を表す文字列を2進数形式に変換する。 

書 式^- #include < sys / iocs . h > 

int _ iocs_datecnv (const char * addr ); 

解 説—— _ iocs _ datecnv 関数は， a ゴみで指定した文字列を2進数形式の日付データへ変換 

する。 

a ゴみには日付を表す文字列の先頭アドレスを指定するが，このアドレスにはスー 
パーパ イザ領域も指定できるので注意すること。 

また，文字列は“1993/06/23” の形式で指定する。日付の区切り記号は“/”でも 
でも，それ以外でもよい。 

_ iocs _ datecnv 関数は IOCS コール 0 x 58 を発行することによつて处理される。 

戻り値——成功した場合は，次のようなビットフィールドを返し，失敗した場合は一1を返 
す。ただし，閏年や大小の月の判定は行わない。 



OOOOvyyy yyvvyyyy mmmmmmmm dddddddd 


• dddddddd 

• TTiTnrnminniTnm 

• yyyyyyyyyyyy 


日 （01 〜 31) 

月 （01 〜 12) 

年（1980〜2079) 


規 格 — XC 
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ライブラリー第 2 部 


_iocs_dayasc 


用 途——曜日を表す2進数のデータを文字列に変換する。 

書式- #include < sys / iocs . h > 

void _ iocs_dayasc (int dav , chax * addr ); 

解 説- _ iocs _ dayasc 関数は，ぬ夕で指定した 2 進数形式の曜日データを文字列に変換 

し，ゴみで指定した領域へ格納する。 

ゴ の; には〇〜6を指定する。この範囲外の値を指定すると，8で割ったあまりが 
使用される（つねに〇〜7を使用する)。 

addr には文字列を格納す るバッファの 先頭アドレスを指定す るが， この バッファ 
は最低3 バイト 以上の領域を確保しなければならない。また，このアドレスには 
ス ー パー バイザ 領域も指定で きるの で注意すること。 

_ iocs _ dayasc 関数は IOCS コール 0 x 5 C を発行することによって処理される。 
戻り値——なし。 

0ゴみで示される バッファには“月”， “火”，“水’，,“木’，，“金’，，“土，，, “ 日”，“?” 
のいずれかが格納される。“?”が格納された場合はぬ少に7を指定したか，指定 
した値を8で割ったあまりが7だったことを示す。 

規 格 — XC 
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Chapter 3 — IOCS コールライブラリ 


iocsdetchr 


用 途一外字パターンを設定する。 


書式 - #include <sys/iocs .h> 

int _iocs_defchr (int type, int code, const void *buif); 


解 説—— _iocs_def chr 関数は，〇?みで指定した外字に心#で指定したパターンデータを 

設定する。 

び/尼には設定する外字のドット数を8または12で指定するが，0を指定した場合 
は8を指定したとみなす。また， a? みにはシフト JIS コードか， JIS 漢字コード 
の 0x7621 〜 0x777E までを指定する。 

(ype に0か8を指定した場合は32バイト，12を指定した場合は72バイトの外 
字パターンがゐ w# に設定され，それぞれ 16x16 ドット， 24x24 ドットの外字パ 
ターンとなる。 

_iocs_defchr 関数は IOCS コール OxOF を発行することによって処理される。 


戻り値——成功した場合は0を返し，〇?みが外字コードでなかった場合は一1を返す。 



規 格 — XC 
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ライブラリー第 2 部 


locsdensns 


用 途——電卓処理を行う。 

書 式-# include <sys/iocs.h> 

void _iocs_densns (void); 

解 説一 _iocs_densns 関数は電卓処理を行う 0 

電卓处理は -iocs_bJteyinp 関数や- iocs_b_keysns 関数などのキー入力関数で处 
理される。 

したがって，キーボードを使用しないでマウスだけを使用する場合は，ソフト 
キーボードが表示されていても電卓が使えないことがある。このような場合， 
_iocs_densns 関数を呼び出しながらマウス处理を行うことで電卓が使えるよう 
になる。 

_iocs_densns 関数は IOCS コール 0x7E を発行することによって処理される。 
戻り値——なし。 

規 格 — XC 

関連項目- _iocs_b_keyinp, _iocs_b_keysns 





Chapter 3— IOCS コールライブラリ 


Jocsdmamode 


用 途 —— DMA の実行モードを調べる。 

書式 - #mclude <sys/iocs.h> 

int _iocs_dmamode (void); 

解 説一 _iocs_dmamode 関数は DMA の実行モードを調べる。 

_iocs_dmamode 関数は IOCS コール 0x8D を発行することによつて处理される。 

戻り値一 ^ 実行モードを返す。実行モードは次のとおり。 

• 0x00 何もしていない 

• 0x8A 転送中 (_iocs_dmamove 関数実行中） 

• 0x8B 転送中 (_iocs_dmamov_l 関数実行中） 

• 0x8C 転送中 （ _iocs_dmamov_a 関数実行中） 

規 格 — XC 

関連項目 - _iocs_dmamov_a, _iocs_dmamov_ 丄， _iocs_dmainove 
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ライブラリー第 2 部 


_iocs_dmamov 


用 途——アレイチヱインモードで DMA 転送を行う。 

僅 瓦 -# include <sys/iocs .h> 

void _iocs_dmamov_a (const struct _chain *tbl, 

void *addr, int mode, int cnt); 

解 説- _iocs_dmamov_a 関数はアレイチエインモードで DMA 転送を行う。 

め/には転送元データチヱイ ンテーブルの アドレスを指定する。め/に指定する 
.chain 構造体は次のとおり。 

struct _ chain { 

void * addr ; /* データバッファの先頭アドレス*/ 

unsigned short len ; /* データバッファの長さ*/ 

>； 

ゴみには転送先アドレスを指定し，こは転送データチヱイ ン テーブルの個数 
を指定する。 

みに指定する値の内容は次のとおり。 


ビット 7 

転送方向 

0 ... tbit 、 ら a ゴゴ r へ転送 

1 … addr から め/へ転送 

ビット 6 〜 4 

つねに 0 

ビット 3 〜 2 

MAC (addrl) 

00 ... カウントしない 

01 •..インクリメント 

10 ...デクリメント 

11 ... 指定不可 

ビット 1 〜〇 

DAC (addr2) 

00 ... カウントしない 

01 •..インクリメント 

10 ...デクリメント 

11...指定不可 


_i 0 cs_dmam 0 v_a 関数は IOCS コール 0x8B を発行することによって処理される0 
戻り値——なし。 

規 格 — XC 
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Chapter 3 — IOCS コーノレライブラリ 


_iocs_dmamovJ 


用 途 ——リンクアレイチヱイン モー ドで DMA 転送を行う。 


rf 式 - #include <svs/iocs .h> 

void _iocs_dmamov_i (const struct _cham2 *tbl, 
void *addr, int mode); 



解 説- _iocs_dmamov ユ関数はリンクアレイチエインモードで DMA 転送を行う。 

め/には転送元データチエインテーブルのアドレスを指定する。め/に指定する 
_chain2 構造体は次のとおり。 

struct _chain2 { 

void *addr; /* データバッファの先頭アドレス*/ 

unsigned short len; /* データバッファの長さ*/ 

const struct _chain2 *next; /* 次のテーブノレアドレス */ 

>； 

最後のテーブルのメンバ next には 0 を指定し， 0 ゴゴ r には転送先アドレスを指定 
する。 

wo みに指定する値の内容は次のとおり。 


ビット 7 

転 32173 问 


0 .. 

. tbl から a ゴみへ転送 


1 .. 

.ad dr から 沩 / へ転送 

ビット 6 〜 4 

つねに 0 

ビット 3 〜 2 

MAC ( addrl ) 


00 . 

.. カウントしない 


01 . 

..インクリメント 


10 . 

•.デクリメント 


11 . 

.. 指定不可 

ビット 1 〜〇 

DAC ( addr 2) 


00 . 

• • カウントしない 


01. 

.. インクリメント 


10 . 

..デクリメント 


11. 

.. 指定不可 


_iocs_dmamov ユ関数は IOCS コール 0x8C を発行することによって姓理される。 
戻り値——なし。 


規 格- XC 
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ライブラリー第 2 部 


_iocs_dmamove 


用 途- DMA 転送を行う。 

僅 式- #include <sys/iocs .h> 

void _iocs_dmamove (voia 木 addrl, 

void *addr2, int mode, int len); 

解 説- _iocs-dmamove 関数は DMA 転送を行う。 

addrl ， a ゴみ 2 には転送の対象となるアドレスを指定し，には転送バイト数を 
指定する。転送するバイト数は OxFFOO バイト以下を指定すること。 

wo みに指定する値の内容は次のとおり。 


ビット7 

転送方向 

〇 … addrl から addr 2 へ嵌表 

1 ... addr 2 から addrl へ転送 

ビット6〜4 

つねに0 

ビッ ト 3〜2 

MAC ( addrl ) 

00 ... カウントしない 

01...インクリメント 

10 ...デクリメント 

11 ...指定不可 

ビット1〜〇 

DAC ( addr 2) 

00 ... カウントしない 

01...インクリメント 

10 .••デクリメント 

11 ... 指定不可 


_iocs_dmamove 関数は IOCS コール 0x8A を発行することによって处理される。 
戻り値——なし。 

規 格 — XC 
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Chapter 3— IOCS コーノレライブラ 1 > 


一 IOCS 


用 途 —— グラフィック画面に塗りつぶしたボックスを描画する。 

書式 - ffinclude <svs/iocs .h> 

int _iocs_fill (const struct _fillptr *ptr); 

解 説一 .iocs_fill 関数はグラフィック画面に塗りつぶしたボックスを描画する。 ptr に 

指定する -: f illptr 構造体は次のとおり。 


struct _fillptr { 
short xl; 
short yl; 
short x2; 
short y2; 


/* 始点の X 座標*/ 
/* 始点の Y 座標*/ 
/* 終点の X 座標*/ 
/* 終点の Y 座標*/ 


unsigned snort color; /* ノ、。レツトコ ー ト */ 


>； 


_iocs_fill 関数は IOCS コール OxBA を発行することによって処理される c 


戻り値 —— 成功した場合は 0 を返し，失敗した場合は次の値を返す。 


-1 グラフィックは使用できない 


規 格 — XC 
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ライブラリー第 2 部 


—iocs—fntget 


用 途一漢字パターンを取得する。 

式- # include <sys/iocs.h> 

int _iocs_fntget unt type, int code, struct _fntbuf *fntbuf); 

解 説- _iocs_fntget 関数は， type ヒ ⑺みで指定した漢字パターンを //7 め w/ で指定した 

-fntbuf 構造体へ格納する。 fntbuf の了 ドレスにはスーパーバイザ領域も指定可 
能なので，誤ったアドレスを与えないように注意すること。 /が如/ に指定する 
-fntbuf 構造体は次のとおり。 

struct _fntbuf i 

short xl ; /* 処理する X 方向のドット数*/ 

short yl ; /* 処理する Y 方向のドット数*/ 

unsigned char buffer [72] ; /* 読み込みバッファ*/ 

>； 

明叱には 8 または 12 を指定するが， 0 を指定した場合は 8 とみなされる。ま 
た， code に はシフト JIS コードか， JIS 漢字コードの 0x2121 〜 0x7E7E まで指 
定する。 

び/^に0か8を指定した場合は36バイト，12を指定した場合は76バイトの外 
字パターンが/价如/に 設定され，それぞれ16 X 16ドット，24 X 24ドッ トの外 
字パターン となる。また// 2^ w / に 設定される内容は漢字 パターンの 縦，横それぞ 
れ のドッ ト数および パターンデータで ある。 

_iocs_fntget 関数は IOCS コール 0x19 を発行することによって处理される。 
戻り値——なし。 

規 格- XC 
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Chapter 3—IOCS コールライブラリ 


_iocs_g_clr—on 


用 途ーグラフィック画面のクリア / 表示を行う。 

# it - frinc 丄 ude <sys/iocs .h> 

void _iocs_g_clr_on (void); 

解 説一 _iocs_g_clr_on 関数は，グラフィック画面のクリアと表示モードの設定を行う。 
このときグラフィックパレットは初期状態に戻される。 

_iocs_g_clr_on 関数は IOCS コール 0x90 を発行することによって処理される。 
戻り値 —— なし。 

規 格 — XC 
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ライブラリー第 2 部 


_iocs_qetgrm 


用 途——グラフ ィッ ク画面からデータを読み込む。 

書 式 -# include <sys/iocs .h> 

int _iocs_getgrm ^struct —getptr *ptr); 

解 説一 .iocs_getgrm 関数はグラフイック画面の読み込みを行う。 /7 ぴ に指定する - getptr 
構造体は次のとおり。 


struct _getptr { 
short xl 
short yl 
short x 2 
short y 2 


/* 開始位置の X 座標*/ 

/* 開始位置の Y 座標*/ 

/* 終了位置の X 座標*/ 

/* 終了位置の Y 座標*/ 
void * buf _ start ; /* バッファの開始アドレス*/ 
void * buf _ end ; /* バッファの終了アドレス*/ 


>； 


バッファに は パ ックされた形で，データ が 格納される。 

_iocs_getgrm 関数は IOCS コール OxBE を発行することによって処理される。 
戻り値 —— 成功した場合は 0 を返し，失敗した場合は次の値を返す。 


-1 グラフィックは使用できない 


規 格 — XC 
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Chapter 3— IOCS コールライブラリ 


Jocsqpalet 


用 途 — グラフィックパレットを設定する。 

# xi - #mclude <sys/iocs .h> 

int _iocs_gpalet (mt no,int color); 

解 説 - _iocs_gpalet 関数はグラフィックパレットを設定する。 

AK? にはパレット番号 （ 0 〜 15) バ〇〜 255) パ〇〜 65535) を指定し， color には力 
ラーコード （ 0 〜 65535) を指定する。ただし， color に —1 を指定すると⑽で指 
定したパレットの読み込みを行う。 

_iocs_gpalet 関数は IOCS コール 0x94 を発行することによって処理される。 
戻り値一⑺紛に一 1 を指定したときだけ，現在のカラーコードを返す。 

規 格 — XC 
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ライブラリー第 2 部 


—locs—hanjob 


用 途 — 半濁点处理を行う。 

書 式 -# include <sys/iocs .h> 

int _iocs_hanjob (char *end); 

解 説 - _iocs_hanjob 関数は半濁点処理を行う 0 

em/ には文字列の終端の null 文字のアドレスを指定する。最後の全角文字に半濁 
点処理ができないときは文字列に ‘ 。，を追加するため， null 文字の後に 3 バイト 
分の 領域が必要である。また， ‘° ，を追加した場合は ‘° ，の 後に null 文字を付 
加するので，文字列の途中を指定すると ‘ 。，の後の文字列が切れてしまう。した 
がって，文字列の途中は指定しないこと。 

_iocs_hanjob 関数は 10 CS コール 0xA5 を発行することによって处理される。 
戻り値 —— 変換ステータスを返す。変換ステータスは次のとおり。 

• 0 最後の全角文字に半濁点処理をした 

• 2 ‘°，を付加した 

規 格 — XC 

関連項目 - _iocs_dakj ob 
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Chapter 3—IOCS コールライブラリ 


—iocs_home 


用 途——グラフィック画面の表示開始位置を設定する。 


舊式- #mclude < sys/iocs . h > 

int _ iocs_home ^mt Dage , mt x , mt y ); 

解 説—— _ iocs_home 関数はグラフィック画面の表示開始位置を設定する。 

page には， 設定するページをビット〇〜3で指定する（ページ3ならビット3)。 
すべてのビットが〇ならば，現在のモードで有効なすべてのページが設定される。 
また，； c ， 少には表示開始座標を指定する（〇〜1023)。 

_ iocs_home 関数は IOCS コール 0 xB 3 を発行することによつて处理される。 

戻り値——成功した場合は0を返し，失敗した場合は次の値を返す。 

•一1グラフィックは使用できない 

• 一2規定外の引数を指定した 

• -3 現在の画面モードでは設定できない 



規 格 — XC 


641 






ライブラリー第 2 部 


—iocshsvtorgb 


用 途—— HSV 方式から RGB 方式への色変換を行う。 


書式 - #include <sys/iocs .h> 

int _iocs_hsvtorgb unt h, mt s, mt v); 

解 説- _iocs_hsvtorgb 関数は， /z, *5, v で指定した HSV 形式の色コードを RGB 形式の 

データに変換する。 

h は色の指定（色相）でそれぞれ32段階ごとのグループに分かれており，色合い 
も指定できる。指定できる値と色合いの対応は次のとおり。 


• 〇 〜31 

• 32〜63 

• 64〜95 

• 96〜127 
• 128〜159 
• 160〜191 
• 192 〜 


赤から黄色 
黄色から緑 
緑からシアン 
シアンから青 
青からマゼンダ 
マゼンダから赤 
禁止 


• s は白レベルの指定（鉋和度）で，0で白， OxlF で原色を表す。また， v は黒レべ 
ルの指定（明るさ）で，0で黒， OxlF で原色を表す。 

_ iocsJisvtorgb 関数は IOCS コール 0 x 12 を発行することによって処理される 0 
戻り値一変換された RGB コードを次のようなビットフィールドで返す。 


00000000 00000000 GGGGGRRR RRBBBBB0 

赤，青，緑はそれぞれ5ビットで，最下位ビットは必ず0である。 


規 格 —— XC 7 
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Chapter 3 — IOCS コールライブラリ 


JocsJisyncst 


用 途—— H - SYNC (水平同期信号）割り込みを設定する。 

書式- #mclude < sys/iocs . h > 

mt _ iocs_hsyiicst (const void * addr ); 

解 説—— - iocsJisyncst 関数は， H - SYNC (水平同期信号）による割り込みを設定する 。 addr 
には割り込み処理アドレスを指定するが，0を指定することで割り込みを禁止で 
きる。 

_ iocs _ hsyncst 関数は IOCS コール 0 x 6 E を発行することによって处理される。 

戻り値——割り込みが設定された場合は0を返し，すでに使用している場合は0以外の値を 
返す。 

規 格 — XC 
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ライブラリー第 2 部 



用 途——プリンタポートの初期化を行う。 

書 式- # include < sys / iocs . h > 

int _ iocs _ init_prn unt line , int width ); 

解 説一 _ i OCS _ init _ P rn 関数はプリンタポートを初期化する。 

//狀には1ページの行数一1を設定し， vv / め/2には1行の桁数一1を指定する。た 
だし，いずれも OxFF を指定することで制限を与えないようにすることができる。 
line と width は- iocs _ outprn 関数のための指定である。 

_ iocs _ init _ prii 関数は IOCS コール 0 x 3 C を発行することによって処理される。 
戻り値——プリンタへの出力が可能ならば 0 x 000020 を返し，不可ならば 0 x 000000 を返す。 
規 格 — XC 
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Chapter 3— IOCS コー J レライブラリ 


—iocs—inp232c 


用 途—— RS -232 C の受信バッファから1バイトデータ読み込む。 

•rf 式- ffinclude < svs/iocs . h > 

mt _ iocs _ inp 232 c ( void ); 

解 説一 _ iocs _ inp 232 c 関数は RS -232 C の受信バッファ内の受信データを1バイトデータ 

読み込む。 

_ iocs _ in P 232 c 関数は IOCS コール 0 x 32 を発行することによって処理される。 
戻り値——読み込んだバイトデータを返す。 

規 格 — XC 
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ライブラリー第 2 部 


—iocs—iplerr 


用 途一 IPL エラー 時の処理を行う。 

•rf 式 -# include <sys/iocs .h> 

void _iocs_iplerr (void); 

解 説 —— _iocs_iplerr 関数は， IPL プログラムでデイスクエラーなどのエラーが発生した 
場合に再起動させるために使用する。 

_iocs_iplerr 関数は IOCS コール OxFE を発行することによって処理される。 
戻り値——なし。 -iocs—iplerr 関数は決して戻ってこない。 

規 格- XC 
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Chapter 3— IOCS コールライブラリ 


—iocs—isns232c 


用 途—— RS -232 C の受信バッファ内にデータがあるかどうかを調べる。 

書式- #include < svs/iocs . h > 

mt _ iocs _ isns 232 c ( voia ); 

解 説- _ iocs _ isns 232 c 関数は RS -232 C の受信バッファ内に受信データがあるかどうか 

調べる。 

_ iocs _ isns 232 c 閨数は IOCS コール 0 x 33 を発行することによつて処理される 0 

戻り値一 0 x 10000+ 受信データを返すが，戻り値が0の場合は，受信バッファ内にデータ 
がないことを示す。 

規 格 — XC 
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ライプラリー第 2 部 


— IOCS—J_SSft 


用 途—— JIS 漢字コードからシフト JIS 漢字コードに変換する。 

書 式- # include < sys/iocs . h > 

mt _ iocs_jissft (mt code ;; 

解 説—— — iocsjissft 関数は， a ) みで指定した JIS 漢字コードをシフト JIS 漢字コー 

ドに変換する。 

— iocsjissft 関数は IOCS コール OxAl を発行することによって処理される。 

戻り値——変換した JIS 漢字コードを返すが，上位16ビットが OxFFFF ならばエラーが発生 
したことを示す。 

規 格 — XC 
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Chapter 3— IOCS コーノレライブラリ 


_iocs_joyget 


用 途ージョイスティックのデータを取得する。 

書式- #include < sys/iocs . h > 

int _ iocs_joyget (mt no ); 

解 説- _ iocs _ joyget 関数はで指定した番号のジョイスティックの状態を調べる。 

は，0でジョイスティックの1番，1で2番となる。 

_ iocs _ joyget 関数は IOCS コール 0 x 3 B を発行することによって处:理される。 
戻り値——成功した場合は0を返し，失敗した場合は次の値を返す。 


7 

6 

5 

4 

3 

2 

1 

0 

1 

A 

B 

1 

右 

左 

下 

上 



B , A はそれぞれジョイスティックのボタンの状態であり，各対応ビットが“1”の 
ときに押されていることを示す。また右，左，下，上はそれぞれジョイスティッ 
クのレバーの 状態であり，“0” で その方向に倒されていることを示す。 


規 格 — XC 
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ライブラリー第 2 部 


—locsledmod 


用 途—— LED つきキーの設定を行う。 

書 式- #include < sys/iocs . h > 

void _ iocs_ledmod unt code , int onoff ); 

解 説- _ iocs ユ edmod 関数は a ? みで指定した LED つきキーを，ガで指定したモード 

に設定する。⑺みには〇〜6を指定し，0^2ぜには l ( ON )， O ( OFF ) を指定する。 

code に指定する値は次のとおり。 


6 

5 

4 

3 

全角 

ひらがな 

INS 

CAPS 


2 

1 

0 

コード入力 

口ーマ字 

かな 


_ iocs _ ledmod 関数は IOCS コール OxOD を発行することによって処理される。 
戻り値——なし。 

規 格 — XC 
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Chapter 3— IOCS コールライブラリ 


—iocs—line 


用 途——グラフィック画面にラインを描画する。 


書式- #mclude < sys/iocs . h > 

int _ iocs_iine (const struct _lineptr * ptr ); 


解 説—— _ i 0 cs_line 関数はグラフィック画面にラインを描画する。ケに指定する- lineptr 

構造体は次のとおり。 


struct _lineptr { 


short xl ; 
short yl ; 
short x 2; 
short y 2; 

unsigned short color ; 


/* 始点の X 座標*/ 
/* 始点の Y 座標*/ 
/* 終点の X 座標*/ 
/* 終点の Y 座標*/ 

/* ハ 0 レツトコード*/ 


unsigned short linestyle ; /* ラインスタイノレ */ 


>； 


_iocs ユ ine 関数は IOCS コール 0 xB 8 を発行することによって処理される。 



戻り値——成功した場合は〇を返し，失敗した場合は次の値を返す。 
•-1 グラフィックは使用できない 


規 格 — XC 
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ライブラリー第 2 部 


_iocsJof232c 


用 途—— RS - 232 C の受信バッファ内のデータ数を調べる。 

書 式- #include < sys / iocs . h > 

mt _ iocs _ lof 232 c ( void ); 

解 説—— _ iocs _ lof 232 c 関数は RS -232 C の受信バッファ内のデータ数を調べる。 

_ iocs _ lof 232 c 関数は IOCS コール 0 x 31 を発行することによって処理される。 

戻り値——受信バッファ内のデータ数を返す。 

規 格 —— XC 
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Chapter 3—IOCS コールライブラリ 


_iocs_ms_curgt 


用 途—マウスカーソルの座標を調べる。 

書式-# include < sys/iocs . h > 

mt _ iocs _ ms_curgt ( void ); 

解 説- , iocs _ ms_curgt 関数はマウスカーソルの座標を調べる。 

, iocs _ ms_curgt 関数は IOCS コール 0 x 75 を発行することによって処理される。 

戻り値——戻り値の上位16ビットに X 座標を返し，下位16ビットに Y 座標を返す。 

規 格 —— XC 
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ライブラリー第 2 部 


_iocs_ms_curoT 


用 途 — マウスカーソルを消去する。 

書 式 ' # include <sys/iocs.h> 

void _iocs_ms_curof (void); 

解 説 - _iocsjoas_curof 閨数はマウスカーソルを消去する。 

_iocs_ms_curof 関数は IOCS コール 0x72 を発行することによって処理される。 

戻り値 —— なし。 

規 格 — XC 
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Chapter 3—IOCS コールライブラリ 


iocsmscuron 


用 途 — マウスカーソルを 表示する。 

書式 - #inclnde <sys/iocs .h> 

void _iocs_ms_curon (void); 

解 説 - _iocs_ms_curon 関数はマウスカーソルを表示する。 

_iocsjms_curon 関数は IOCS コール 0x71 を発行することによつて处理される。 

戻り値 —— なし。 

規 格 —— XC 
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ライブラリー第 2 部 


_iocs_ms_curst 


用 途 —— マウスカーソルの 座標を設定する。 

書 式- #include <sys/iocs .h> 

int _iocs_ms_curst (mt x,int y ノ； 

解 説 - _iocs_ms_cur st 関数は マウスカーソルの 座標を， ズ，アで 指定した座標に設定 

する。 

_iocs_ms_curst 関数は IOCS コール 0x76 を発行することによって処理される。 
戻り値——正常に設定できた場合は0を返し，失敗した場合は一1を返す。 

規 格- XC 
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Chapter 3—IOCS コーノレライブラリ 


—iocs—ms—getdt 


用 途——マウスの移動量とボタンの状態を調べる。 

•b 式^- ^include < sys / iocs . h > 

mt _ iocs _ ms_getdt ( void ); 

解 説- _ iocs _ ms _ getdt 関数はマウスの移動量とボタンの状態を調べる。 

_ iocs _ ms _ getdt 関数は IOCS コール 0 x 74 を発行することによって処理される。 


戻り値一戻り値は次のとおり。 


•ビット31〜24 
• ビット23〜16 
• ビット15〜8 
•ビット7〜〇 


X 方向移動量 
Y 方向移動量 

左ボタンの状態 （ OxFF で ON ， 0で OFF ) 


右ボタンの状態 （ OxFF で ON , 0で OFF ) 


規 格 ^ XC 
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ライブラリー第 2 部 



用 途——マウスを初期化する。 

書 式- # include < sys / iocs . h > 

void _ iocs _ ms_init ( void ); 

解 説—— docsjns - init 関数はマウスの初期化を行う。 

_ iocsjis _ init 関数は IOCS コール 0 x 70 を発行することによって処理される。 

戻り値——なし。 

規 格 —— XC 
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Chapter 3 — IOCS コールライブラリ 


_iocs—ms—limit 


用 途——マウスカーソルの移動範囲を設定する。 

■rf 式- #mclude < sys/iocs . h > 

mt _ iocs _ ms_limit (mt xs , int vs , int xe , int ve ); 

解 説- — iocsjms _ limit 関数はマウスカーソルの移動範囲を，^ < x < xe t ys <y < ye 

に設定する。 

_ iocs _ ms_limit 関数は IOCS コール 0 x 77 を発行することによって处理される。 
戻り値一正常に設定できた場合は〇を返し，失敗した場合は一1を返す。 

規 格 — XC 
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ライブラリー第 2 部 


_iocs ms offtm 


用 途——マウスボタンを離すまでの時間を調べる。 

書 式^- # include < svs / iocs . h > 

int _ iocs _ ms_offtm (int mode , mt max ;; 

解 説一 _ iocsjns _ offtm 関数はマウスボタンを離すまでの時間を調べる。 mode が 0なら 

ば左，一1ならば右のボタンを調べる。には待ち時間の最大値を指定するが， 
0を指定するといつまでも侍ち続ける。 

_ iocs _ ms _ offtm 閨数は IOCS コール 0 x 78 を発行することによって処理される。 

戻り値——待ち時間の残り （1 〜 65534) を返す。ただし，0の場合はドラッグが行われたこ 
とを示し，一1の場合は待ち時間の最大値を越えたことを示す。 

規 格 — XC 
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Chapter 3— IOCS コー J レライブラリ 


Jocs_ms_ontm 


用 途——マウスボタンを押すまでの時間を調べる。 

書式- #mclude < sys / iocs . Ja > 

int _ iocs _ ms_ontm (int mode , mt max ); 

解 説- _ iocs _ ms _ ontm 関数はマウスボタンを押すまでの時間を調べる。 mode が Q なら 

ば左，一1ならば右のボタンを調べる。には待ち時間の最大値を指定するが， 
0を指定するといつまでも侍ち続ける。 

_ iocsjns _ ontm 関数は10 CS コール 0 x 79 を発行することによって処理される。 

戻り値——待ち時間の残り （1 〜65 5 34)を返す。ただし，0の場合はドラッグが行われたこ 
とを示し， 一; [ の場合は待ち時間の最大値を越えたことを示す。 

規 格 — XC 
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ライブラリー第 2 部 


一 iocs—ms patst 


用 途—マウスカーソルのパターンを定蠢する。 


書 式- # include < sys/iocs . h > 

void _ iocs _ ms_patst (int no , const struct _patst * addr ); 


解 説- _ iocs _ ms _ patst 関数は，で指定したマウスカーソルのパターンを設定する 0 


似/みにはパターンデータのアドレスを指定する。似/ゴ/•に指定する- patst 構造 
体は次のとおり。 


struct _Datst { 


>； 


short offsetx; 
short offsety; 
short shadow[16]; 
short pattern[16]; 


/* パターン左端からマウス座標までのドット数*/ 
/* パターン上端からマウス座標までのドット数*/ 
/* パターンの陰のデータ*/ 

/* パターンの表示データ*/ 


_ iocsjns _ patst 関数は IOCS コール 0 x 7 A を発行することによって処理される 0 


民り値-なし。 


規 格- XC 
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Chapter 3— IOCS コーノレライブラリ 


_iocs_ms_sel 


用 途—— マウスカーソルを 選択する。 

■rf 式- #mclude < sys / iocs . h > 

void _ iocs _ ms_sel (int no ); 

解 説一 _ iocs _ ms _ sel 関数は，で指定したマウスカーソルを選択する。 

_ iocsjns _ sel 関数は IOCS コール 0 x 7 B を発行することによって処理される。 

戻り値-なし。 

規 格- XC 
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ライブラリー第 2 部 


—iocs_msselz 


用 途——マウスカーソルを複数選択し，アニメーションを作成する。 

# 式'- # include < sys / iocs . h > 

void _ iocs _ ms _ sel 2 〈const short ; 

解 説—— _ i 0 CS _ m S _ S el 2 関数はマウスカーソルを複数選択して，アニメーションを作成す 
る。め/には カーソル 番号 テーブルの アドレスを指定する。 カーソル 番号 テーブル 
は short 型の配列で，最終データには一1を指定すること。 

_ iocsjns _ sel 2 関数は IOCS コール 0 x 7 C を発行することによって処理される。 

戻り値-なし。 

規 格 — XC 
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Chapter 3— IOCS コーノレライブラリ 



用 途——マウス カーソルの 表示 モー ドを調べる。 

■rf ェく- #incmde < sys/iocs . h > 

mt _ iocs _ ms_stat ( void ); 

解 説一 _ iocsjns _ stat 関数は マウスカーソルの 表示 モー ドを調べる。 

_ iocs _ ms _ stat 関数は IOCS コール 0 x 73 を発行することによって処理される。 

戻り値——マウスカーソルが表示中ならば OxFFFF を返し，表示中でなければ0を返す。 


規 格 ^— XC 
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ライブラリー第 2 部 


locsontime 


用 途——電源投入またはリセットしてからの経過時間を調べる。 

書 式 "——# include < sys / iocs . h > 

int _ iocs_ontime 、 voia ); 

解 説一 _ i 0 CS _ cmtim e 関数が電源投入されるか，またはリセットしてからの経過時間を 

調べる。 

_ iocs _ ontime 関数は10 CS コール 0 x 7 F を発行することによつて处理される〇 

戻り値——0秒〜23時間59分59秒 99(0 〜8 6 3"")までの値を返す。この値は1日を越 
えると0にリセットされる。 

規 格一 XC 
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Chapter 3— IOCS コールライブラリ 


iocs.opmintst 


用 途—— FM 音源 IC ( YM 2151) による割り込みを設定する。 

僅 式- #mclude < sys / iocs . h > 

mt _ iocs_opmintst (const void * addr ); 

解 説—— _ iocs _ opmintst 関数は， FM 音源 （ YM 2151) による割り込みを設定する 。 addr {こ 
は割り込み処理アドレスを指定するが，0を指定することで割り込みを禁止で 
きる。 

なお， FM 音源デバイスドライバ （“0 PMDRV . X ” など）を組み込んでいる状態で割 
り込みの変更を行ってはならない。 

_ iocs _ opmintst 関数は IOCS コール 0 x 6 A を発行することによって処理される。 

戻り値——割り込みが設定された場合は〇を返し，すでに使用している場合は〇以外の値を 
返す。 

規 格一 XC 
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ライブラリー第 2 部 


— ■ocsoDmset 


用 途一 FM 音源 （ YM 2151) にデータを書き込む。 

書 式^ #include < sys/iocs . h > 

void _ iocs_opmset (mt addr,int data ); 

解 説—— _ iocs_opmset 関数は FM 音源 ( YM 2151) にデータを書き込む 0 

addr には書き込むレジスタのアドレスを指定し， data には書き込むデータを指 
定する。 

データの書き込みは FM 音源内部のビジーフラグの状態にしたがって行われる。 
ただし， FM 音源デバイスドライバ （“0 PMDRV . X ” など）が動作中でかつ曲を演奏し 
ている場合はデータの書き込みを行ってはならない。 

_ iocs _ opmset 関数は IOCS コール 0 x 68 を発行することによって处理される。 
戻り値——なし。 

規 格- XC 
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Chapter 3— IOCS コールライブラリ 


一 iocs opmsns 


用 途—— FM 音源 ( YM 2151) のステータスを読む。 

rf 式- #mclude < sys / iocs . h > 

mt _ iocs_opmsns ( void ); 

解 説一 _ iocs _ opmsns 関数は FM 音源 ( YM 2151) のステータスを読み込む。 

_ iocs _ opmsns 関数は IOCS コール 0 x 69 を発行することによって処理される。 

戻り値—— FM 音源 （ YM 2151) のステータスを返す。ステータスのビットフイールドの内容 
は次のとおり。 


•ビット7 書き込み禁止フラグ （0 で書き込み可) 
• ビット1 タイマ A オーバ フロー 
•ビット0 タイマ B 才ーバフロー 


規 格一 XC 
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ライブラリー第 2 部 


locsoscuror 


用 途—力ーソルを消去する。 

書 式~- #include < sys / iocs . h > 

void _ iocs _ os_curof ( void ); 

解 説—— _ i OCS _ OS _ curof 関数はカーソルを消去する （“ esc [>5 h ” を出力した場合と同じ)〇 

_ iocs _ os _ curof 関数は IOCS コール OxAF を発行することによって処理される 0 

戻り値——なし。 

規 格 — XC 
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Chapter 3 —— IOCS コーノレライブラリ 


_iocs_os_curon 


用 途— カーソルを 表示する。 

書式- #mclude < sys/iocs . h > 

void _ iocs _ os_curon ( void ); 

解 説一 - iocs - os — curcm 関数はカーソルを表示する （“ eSC [> 5 l ” を出力した場合と同じ)〇 

_ iocs _ os _ curon 関数は IOCS コール OxAE を発行することによって処理される。 

戻り値——なし。 

規 格 — XC 
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ライブラリー第 2 部 


iocs_osns2^2c 


用 途—— RS -232 C が送信可能かどうかを調べる。 

書式- #mcluae < sys/iocs . li > 

int _ iocs _ osns 232 c ( void ); 

解 説一 _ iocs _ osns 232 c 関数は RS -232 C が送信可能な状態かどうかを調べる。 

_ iocs _ osns 232 c 関数は10 CS コール 0 x 34 を発行することによつて処理される。 

戻り値——送信可能 （バッファが 空で，フロー制御も送信可能の状態）ならば0以外の値を返 
し，送信不可能ならば0を返す。 

規 格 — XC 
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Chapter 3— IOCS コールライブラリ 


—iocs—out232c 


用 途- RS -232 C へ 1 バイト送信する。 

書式- #include < sys / iocs . h > 

void _ iocs _ out 232 c (mt code ); 

解 説- _ iocs _ out 232 c 関数は， CO みで指定した 1 バイトデータを RS -232 C へ送信する。 

_ iocs _ out 232 c 閨数は IOCS コール 0 x 34 を発行することによって処理される。 

戻り値 ——なし。 

規 格—— XC 
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ライブラリー第 2 部 


—IOCS_OUtlpt 


用 途——プリンタへの直接出力を行う0 

書式 -# include <svs/iocs.h> 

void _iocs_outlpt (int code); 

解 説一 _io CS _outlpt 関数は a? みで指定した 1 バイトデータを，プリンタへ直接出力す 

る（漢字処理などは行わない)。 

一 iocs-outlpt 関数は IOCS コール 0x3E を発行することによって処理される。 
戻り値——なし。 

規 格- XC 


674 






Chapter 3— IOCS コーノレライブラリ 


一 locs—outprn 


用 途——プリンタにデータを出力する。 

書式- #mclude < sys / iocs . h > 

void _ iocs_outprn (int code ); 

解 説- _ iocs_outprn 関数は， co みで指定した 1 バイトのデータを，プリンタへ出力す 

る（シフト JIS コードで漢字処理を行う）。 

_ iocs_outprn 関数は IOCS コール 0 x 3 F を発行することによって処理される。 

戻り値-なし。 

規 格 — XC 
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ライブラリー第 2 部 



用 

奎 

解 


途——グラフィック画面のペイントを行う。 

式- # inc 丄 ude < sys / iocs . h > 

int _ iocs_paint (struct _paintptr * ptr ); 

説- _ iocs_paint 関数はグラフィック画面のペイントを行う 0 尸ぴに指定する- paintptr 

構造体は次のとおり。 

struct _paintptr { 

short x ; /* ペイント開始位置の X 座標*/ 

short y ; /* ペイント開始位置の Y 座標*/ 

unsigned short color ; /* ノヽ 0 レツトコ——ド */ 


/* 作業領域先頭ァ ドレス*/ 
/* 作業領域終了ア ドレス*/ 


void * buf _ start ; 
void * buf _ end ; 


>； 

_ iocs_paint 関数は IOCS コール OxBC を発行することによって処理される。 
値——成功した場合は0を返し，失敗した場合は次の値を返す。 

•—1 グラフィックは使用できない 


用 

奎 

解 


規 


格 — XC 






Chapter 3— IOCS コールライブラリ 


Joes .point 


用 途ーグラフィック画面の指定座標のパレットコードを調べる。 

書式- #include < svs/iocs . h > 

int _iocs 一 point (const struct _pointptr * tvtr ); 

解 説- _ iocs_point 関数は，指定したグラフィック画面の座標のパレットコードを調べ 

る。 p //* に指定する- pointptr 構造体は次のとおり。 

struct _pomtptr { 

short x; /* X 座標*/ 

short y; /* Y 座標*/ 

unsigned short color; /* ノ、。レツトコード */ 

>； 

_ iocs_point 関数は IOCS コール 0 xB 7 を発行することによって処理される。 

戻り値-成功した場合は0を返し，パレットコードが- pointptr 構造体の color に格納さ 

れる。失敗した場合は次の値を返す。 

•-1 グラフィックは使用できない 


規 格 ^— XC 
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ライブラリー第 2 部 


Jocs_prmntst 


用 途——プリンタ割り込みを設定する。 

書 式 - #include <sys/iocs .h> 

int _iocs_prnintst (const void *addr ノ； 

解 説—— -iocs-prnintst 関数はプリンタ割り込みを設定する。みには割り込み処理ア 
ドレスを指定するが，〇を指定することで割り込みを禁止できる。 

_iocs_prnintst 関数は IOCS コール 0x6F を発行することによって処理される。 

戻り値——割り込みが設定された場合は0を返し，すでに使用している場合は0以外の値を 
返す。 

規 格 —— XC 
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Chapter 3 — IOCS コーレライブラリ 



用 途ーグラフィック画面に点を描画する。 

xi - #include < sys/iocs . h > 

mt _iocs_pset (const struct _psetDtr * ptr ); 

解 説—— _ iocs . pset 関数はダラフィック画面の指定した座標に点を描く。かに指定する 

_ psetptr 構造体は次のとおり 0 

struct _psetptr { 


short x; 
short v; 


/* 描画する X 座標 */ 
/* 描画する Y 座標 */ 


unsigned short color; /* 描画パレットコード */ 


_ iocs _ pset 関数は IOCS コール 0 xB 6 を発行することによって処理される。 


戻り値——成功した場合は0を返し，失敗した場合は次の値を返す。 


•-1 グラフィックは使用できない 


規 格 — XC 


679 






ライブラリー第 2 部 



用 

書 

解 


途—— グラフィック 画面にデータを書き込む。 

式-# include < sys / iocs . h > 

int _ iocs 一 putgrm Cconst struct _putptr * ptr ); 

説- _ iocs _ p\rtgrm 関数はグラフィック画面にデータを書き込む。 p びに指定する- putptr 

構造体は次のとおり。 

struct _putptr i 

short xl; /* 開始位置の X 座標 */ 


/* 開始位置の Y 座標 */ 
/* 終了位置の X 座標 */ 
/* 終了位置の Y 座標 */ 


short yl ; 
short x2; 
short v2; 


const void *buf_staxt; /* バッファの開始アドレス */ 
const void *buf_end; /* バッファの終了アドレス */ 


バッファ には ハ。 ックされた形で，データを格納すること。 

_ iocs_putgrm 関数は IOCS コール OxBF を発行することによって処理される。 

値——成功した場合は0を返し，失敗した場合は次の値を返す。 

•—1グラフィックは使用できない 


用 

書 

解 


規 格 — XC 





Chapter 3— IOCS コーノレライブラリ 


jocs— rmacnv 


用 途—ローマ字/かな変換を行う。 


書 

解 


戻 


式- #include < sys/iocs . h > 


mt _ iocs_rmacnv (mt coae , char * wptr , char * aptr ;; 

説- _ iocs_rmacnv 関数はローマ字変換を行う。〇?みには文字コードを指定し ， wptr 

にはワークボインタを，即かには変換結果を格納する領域へのボインタを指定 
する。 


. iocs^-macnv 関数は IOCS コール 0 xA 3 を発行することによって処理される。 
値——変換ステータスを返す。変換ステータスは次のとおり。 


• 0 変換の途中 

•一1 変換不可能 

• 上記以外 変換文字数を示す （ wp かの領域に変換途中の文字が残っている 

可能性がある） 


規 格 —— XC 
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ライブラリー第 2 部 


_iocs_romver 


用 途一 ROM のバージョンと作成日付を調べる。 

書式-# include < svs/iocs . h > 

int _ iocs_romver ( void ); 

解 説- _ iocs _ romver 関数は ROM のバージヨンと作成日付を調べる。 

_ iocs _ romver 関数は IOCS コール 0 x 8 F を発行することによって処理される。 

戻り値—— ROM のバージョン情報を次のようなビットフィールドで返す。 

WWVWV YYYYYYYY MMMMMMMM DDDDDDDD 


• VWWVW 

• YYYYYYYY 

• MMMMMMMM 

• DDDDDDDD 


ハ^-ジョン 

年 

月 

日 


規 格- XC 
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Jocsscroll 


用 途——テキスト/グラフィックの表示開始座標を設定する。 

xi - #include < sys/iocs . h > 

void _ iocs_scroll unt mode , int x , int y ); 

解 説- - iocs _ scroll 関数は wo みで指定した画面の表示開始座標を，ズ，少で指定した 

座標に設定する。 

みに指定できる値は次のとおり。 

• 0 グラフィックスクリーン0の設定 
• 1 グラフィックスクリーン1の設定 

• 2 グラフィックスクリーン2の設定 

• 3 グラフィックスクリーン3の設定 

•8 テキスト画面の設定 

_ iocs _ scroll 関数は10 CS コール OxlD を発行することによって处理される。 
戻り値——なし。 

規 格 —— XC 
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ライブラリー第 2 部 


iocs—set232c 


用 途一 RS -232 C の通信モードを設定する。 

書 式- # include < sys/iocs . h > 

int _ iocs _ set 232 c (int mode ); 

解 説—— _ iocs _ set 232 c 関数は， RS -232 C の通信モードを咖みで指定したモードに設定 
する。洲?ゐに指定するビットフィールドの内容は次のとおり。 

SS PP LL X 0 0000 BBBB 

上記形式の SS でストップビットの指定をし，次の値をとる。 

• 011ビット 

• 10 1.5 ビット 

• 11 2ビット 

• 00 2ビット 

上記形式の PP でパリティビットの指定をし，次の値をとる。 


• 01奇数 
• 11偶数 

• 00 ハ。リテイなし 
•10 ハ 。 リテイなし 

上記形式の LL でビット長の指定をし，次の値をとる。 

• 00 5ビット以下 

• 01 6ビット 

• 10 7ビット 

• 118ビット 

上記形式の X で X フロー制御の指定をし，次の値をとる。 


• 0 処理しない 
• 1 処理する 


上記形式の BBBB で通信速度の指定をし，次の値をとる。 
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• 0000 75 bps 

• 0001 150 bps 





Chapter 3—IOCS コールライブラリ 


• 0010 

300 bps 

• 0011 

600 bps 

• 0100 

1200 bps 

• 0101 

2400 bps 

• 0110 

4800 bps 

• 0111 

9600 bps 

• 1000 

19200 bps 

• 1001 

38400 bps 


19200 bps ， 38400 bps の通信速度での処理は， RS -232 C ドライバが処理する。た 
だし，使用するドライバによっては19200 bps や38400 bps の指定ができない場 
合がある。またドライバを組み込んでいない場合，19200 bps , 38400 bps はそれ 
ぞれ 75 bps ，150 bps と認識される。 

_ iocs _ set 232 c 関数は IOCS コール 0 x 30 を発行することによって処理される。 

戻り値-みに一1を指定したときだけ，現在のモードを返す。 

規 格一 XC 
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ライブラリー第 2 部 



用 途——シフト JIS 漢字コードから JIS 漢字コードに変換する。 

書式- #mc 丄 ude < sys/iocs . h > 

int _ iocs_sftjis (mt code ); 

解 説一 _ iocs_sftjis 関数は〇?みで指定したシフト JIS 漢字コードを， JIS 漢字コー 
ドに変換する。 

_ iocs_sftjis 関数は IOCS コール OxAO を発行することによって処理される。 

戻り値-変換した JIS 漢字コードを返すが，上位16ビットが OxFFFF ならばエラーが発生 

したことを示す。 

規 格 — XC 
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__iocs_skey 


用 途—ソフトキーボードを制御する。 

iv - #inc 丄 ude < sys / iocs . h > 

int _ iocs _ skey_mod unt mode , int x , int y ); 

解 説一 — iocs—skeyjnod 関数はソフトキーボードの制御を行う。 

wo みには次の値を指定する。 

• 0 ソフトキーボード消去 

• 1 ソフトキーボード表示（表示状態では無効） 

• 2 ソフトキーボード表示状態の検査 

•-1 ソフトキーボード自動制御（右ボタンで表示/消去） 

wo みでソフトキーボードの表示を選択した場合，； c , 少にはソフトキーボードを 
表示する座標を指定する。 

_ iocs _ skey _ mod 関数は IOCS コール 0 x 7 D を発行することによって処理される。 
戻り値一-ソフトキーボードの状態を返す。 

• 0 消去状態 
• 1 表示状態 

規 格—— XC 
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—iocs_skeyset 


用 途——指定したキーが押されたことにする。 

書式-# include < sys / iocs . h > 

int _ iocs_skeyset (int code ;; 

解 説- _ iocs ~ skeyset 関数は， M 办で指定したキーがキーボードから入力されたかのよ 

うに，内部情報を設定する。 

キーの番号は， _ iocs _ bitsns 関数で指定するキーコードグループを8倍したも 
のに，対象キーのビット位置を加えた値を指定する。たとえば， ‘ A ’ が入力され 
たかのようにするには， ‘ A ’ のグループが3,ビット位置が6であることから， 
3 x 8+6=0 xlE を設定すればよいことになる。 

、 iocs _ skeyset 関数は IOCS コール 0 x 04 を発行することによって处理される。 

戻り値——指定したキーコードグループの押下げ状態を返す。該当ビットが1ならば，その 
キーが押されていることを示す。 

規 格- XC 

関連項目- _ iocs_bitsns 
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—iocs—snsprn 


用 途——プリンタ出力が可能かどうかを調べる。 

谨式- frinc 丄 ude < sys / iocs . h > 

int _ iocs_snsprn 、 void ); 

解 説- _ iocs _ snsprn 関数はプリンタへの出力が可能かどうかを調べる。 

_ iocs _ snsprn 関数は IOCS コール 0 x 3 D を発行することによって処理される。 

戻り値ープリンタへの出力が可能ならば0以外を返し，出力不可ならば0を返す。 

規 格 — XC 
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_iocs_sp_cgclr 


用 途一 PCG をクリアする。 

書 式- #include < sys/iocs . h > 

11 it _ iocs _ sp_cgclr (int code ;; 

解 説—— _ iocs _ sp.cgclr 関数は，⑺みで指定した PCG をクリアする。 

_ iocs _ sp~cgclr 閨数は IOCS コール 0 xC 3 を発行することによって処理される。 

戻り値——成功した場合は0を返し，失敗した場合は次の値を返す。 

•一1画面モードエラー（画面サイズが768 X 512のときなど） 

規 格 — XC 
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—iocs—sp_defcg 


用 途- PCG を設定する。 

1 ¢- #mclude < sys/iocs . h > 

mt _ iocs _ sp_defeg (int code,int size , const void * addr ); 

解 説- _ iocs _ sp _ defcg 関数は co みで指定した PCG をゴめ*で指定した パターンデータ 

で設定する。 

⑺みにはパターンコード （0 〜 255) を指定し，にはパターンサイズを指定 
する。 

指定できる値は次のとおり。 

• 0 8 X 8 ドットパターン 

• 1 16 X 16 ドットパターン 

また， aA / r には パターンデータバッファの アドレスを指定する。 このときパター 
ンデータの サイズはにより次のようになる。 


• 0 32バイト 

•1 128バイト 

_ iocs _ sp _ defcg 関数は IOCS コール 0 xC 4 を発行することによって処理される。 
戻り値——成功した場合は〇を返し，失敗した場合は次の値を返す。 

•一1画面モードエラー（画面サイズが768 X 512のときなど） 



規 格 — XC 
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_iocs_sp_gtpcg 


用 途—— PCG を読み込む。 

書 式 - - #include <sys/iocs .h> 

int _iocs_sp_gtpcg (int code, int size, void *addr); 

解 説一 _iocs_sp_gtpcg 関数は co みで指定した PCG を読み込み，似/め*で指定した領域に 

格納する。 

⑺みにはパターンコード （0 〜 255) を指定し， • size にはパターンサイズを指定 
する。 

size に指定できる値は次のとおり。 

• 0 8 X 8ドットパターン 

• 1 16 X 16ドットパターン 

また， a ゴみにはパターンデータバッファのアドレスを指定する。このときパター 
ンデータのサイズは size により次のようになる。 

• 0 32バイト 

•1 128バイト 

_ iocs _ sp _ gtpcg 関数は IOCS コール 0 xC 5 を発行することによって处理される。 
戻り値——成功した場合は0を返し，失敗した場合は次の値を返す。 

•一1画面モードエラー（画面サイズが768 X 512のときなど） 

規 格 —— XC 
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—iocs—sp__mt 


用 途——スプライト画面を初期化する。 

書式- #mclude < sys / iocs . h > 

mt _ iocs _ sp_init ( void ); 

解 説一 _ iocs _ sp _ init 関数はスプライト画面の初期化を行う。 

_ iocs _ sp _ init 関数は IOCS コール OxCO を発行することによって処理される。 

戻り値——成功した場合は0を返し，失敗した場合は次の値を返す。 

•-1 画面モードエラー（画面サイズが768 X 512のときなど） 

規 格 —— XC 



693 






ライブラリー第 2 部 


IOCS— sp off 


用 途——スプライト画面を非表示にする。 

書 式- #include < sys/iocs . h > 

void _ iocs _ sp_off ( void ); 

解 説—— _ iocs _ S p _ off 関数はスプライト画面が表示されないようにする。 

_ iocs _ sp _ off 関数は IOCS コール 0 xC 2 を発行することによつて处:理される。 


戻 

り値- 

—なし 

規 

格- 

—— XC 
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—■ocsspon 


用 途—スプライト画面を表示する。 

谱式- frinc 丄 ude < sys / iocs . h > 

int _iocs_sD_on 、 void); 

解 説一 _ i 0 C s _ S p _ 0 n 関数はスプライト画面が表示されるようにする。 

_ iocs _ sp _ on 関数は IOCS コール OxCl を発行することによって处理される。 

戻り値——成功した場合は0を返し，失敗した場合は次の値を返す。 

•-1 画面モードエラー（画面サイズが768 X 512のときなど） 

規 格 — XC 
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」 ocs—sp—reggt 


用 途——スプライトレジスタを読み込む。 

書 式- # include < sys/iocs . h > 

int _ iocs _ sp_reggt (int no , int * x , int * y , int * code,int * prw ); 

解 説- _ iocs _ sp _ xeggt 関数はスプライトレジスタの読み込みを行う。 

にはスプライトプレーン番号 （0 〜 127) を指定し，； C , 少にはそれぞれ X 座標， 
Y 座標を格納する領域へのボインタを指定する。返される値は〇〜1023の範囲 
である。 

また， prvv にはプライオリティを格納する領域へのポインタを指定する。返され 
る値は〇〜3の範囲であり意味は次のとおり。 

•0 スプライトは表示しない 
•1 スプライトは BGO ， BG 1 よりも後ろ 

• 2 スプライトは BGO と BG 1 の間 

• 3 スプライトは BGO ， BG 1 よりも前 

code には次の内容を格納する領域へのポインタを指定する。 


ビット 16 

〜32 

つねに0 


ビット 15 


垂直反転 （0= 標準， 

1= 反転) 

ビット 14 


水平反転（〇=標準， 

1= 反転） 

ビット 12 

〜13 

つねに0 


ビット8 严 

-11 

パレットブロック番号 （0 〜ゴ 

ビット 0 r 

- 7 

パターンコード (0 

〜 255) 


_ iocs _ sp_reggt 関数は IOCS コール 0 xC 7 を発行することによって処理される。 

戻り値——成功した場合は0を返し， X 座標， Y 座標，パターンコード，プライオリティが 
それぞれ指定した領域に格納される。失敗した場合は次の値を返す。 

•-1 画面モードエラー（画面サイズが768 X 512のときなど） 

規 格 —— XC 
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用 途-スプライトレジスタを設定する。 

■rf 式'- #include < sys / iocs . h > 

mt _ iocs _ sp_regst (int no , int mode , 

int x , int y , int code , int prw ); 

解 説- _ iocs _ sp _ regst 関数はスプライトレジスタの設定を行う。 

にはスプライトプレーン番号 （0 〜 127) を指定し， wo みには設定に先だって 
垂直帰線期間を検出するかどうかを設定する。最上位ビットが0ならばレジスタ 
は垂直帰線期間を検出後に設定され，1ならば無条件に設定される。 

X ,少にはそれぞれ X 座標， Y 座標 （0 〜102 3) を，⑺みにはパターンコードを， 
pnv にはスプライトのプライオリティ （0 〜 3) を設定する。いずれも一1か才旨定さ 
れた場合は設定を変更せずに現在の設定値を使用する。詳細は- i 0 CS _ S p _ reggt 関 
数を参照のこと。 

_ iocs _ sp _ regst 関数は IOCS コール 0 xC 6 を発行することによって处理される。 
戻り値一成功した場合は0を返し，失敗した場合は次の値を返す。 


•一1画面モードエラー（画面サイズが768 X 512のときなど) 


規 格 — XC 

関連項目- _ iocs _ sp_reggt 

変 更——従来では，引数 mode は no , mode の2 つの引数にわかれていたが，元々の 

IOCS コールの 仕様通り，現在のではこれらを1 つに まとめた。 

[新書式] 

int _ iocs _ sp_regst (int mode , int x , int y , int code , int prw ;; 



697 







ライブラリー第 2 部 


一 iocs—spalet 


用 途 ——スプライトパレットの設定/読み込みを行う。 

書 式 - #include < sys / iocs . h > 

int _ iocs 一 sr>alet (int mode , int block , mt color ); 

解 説 —— _ iocs _ spalet 関数は スプライトパレ ッ トの 設定と読み込みを行う。 

mo みには， 垂直帰線期間と 同期してパレットを変更するか，または同期を取ら 
ずに変更するかを指定する。垂直帰線期間を検出しないでパレットコードを変更 
すると，画面にちらつきが発生するので注意すること。 

mo みに設定する値は次のとおり 0 

• 0 x 00 〜 OxOF 垂直婦線期間を検出後に設定 

• 0 x 80 〜 0 x 8 F 検出しない 

block には パレ ッ トフ。ロック （0 〜 15) を指定し， ⑺/〇, には カラーコード （0 〜 
65535) を指定する。ただし， カラーコードに 一1を指定した場合， カラーコード 
は変更せず，読み込みだけを行う。 

_ iocs _ spalet 関数は IOCS コール OxCF を発行することによって処理される。 
戻り値 ——成功した場合は設定前のカラーコードを返し，失敗した場合は次の値を返す。 

• 一2 パラメータエラー （パレット ブロ ック〇のアクセス） 

規 格- XC 

関連項目 - _ iocs_bgtextcl 
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一 iocs_symbol 


用 途ーグラフィック画面に文字を描画する。 


書式- #include < svs/iocs . h > 

int _ iocs_symbol (const struct _symbolptr * ptr ); 


解 説—— — iocs - symbol 関数はグラフィック画面に文字を描画する ( 

. symbolptr 構造体は次のとおり。 


ptr に 指定する 


struct _symbolptr { 
short xl; 
short yl; 

const char *string_address; 
unsigned char mag_x; 
unsigned char mag_y; 
unsigned short color; 
unsigned char font_type; 
unsigned char angle; 

}； 


/* 描画を開始する X 座標 */ 
/* 描画を開始する Y 座標 */ 
/* 描画文字列のア ドレス*/ 
/* 横倍率 */ 

/* 縦倍率 */ 

/* パレットコード*/ 

/* 文字フォントのタイプ */ 
/* 角度 コ- ド */ 


xl ， yl にはグラフィック画面の描画開始座標を指定する。通常，座標は描画する 
文字列の左上隅の座標を指定するが，回転角度が90度，180度，270度の場合は 
それぞれ左下，右下，右上隅の座標となる。 


mag _ x には文字の横倍率を， mag _ y には文字の縦倍率をそれぞれ指定する。ただ 
し，この倍率の指定は文字の縦横に対しての倍率であり，画面の縦横に対してで 
はないので注意すること。 

また color には表示色のパレットコードを， font — type には次の文字フォントの 
タイプを指定する。指定することのできるフォントタイプは次のとおり。 


• 0 12 X 12ドットフォント 

• 1 16 X 16ドットフォント 

• 2 24 X 24ドットフォント 



angle には次の回転角コードを指定する 0 


• 0 

通常 

• 1 

90度回転 

• 2 

180度回転 

• 3 

270度回転 


_ iocs _ symbol 関数は IOCS コール OxBD を発行することによって処理される。 
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戻り値——成功した場合は0を返し，失敗した場合は次の値を返す。 
•-1 グラフィックは使用できない 

規 格 — XC 
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—iocs—tcolor 


用 途ーテキストのカラーを選択する。 

■rf 式- frinc 丄 ude < sys/iocs . h > 

mt _ iocs_tco 丄 or (int color ); 

解 説一 _ iocs _ tcolor 関数はテキストカラーを選択する。 

⑺ / or には〇〜15までの値が指定可能であるが，原則としては1, 2, 4，8のみ 
指定すること。 

• 1 OxEOOOOO 〜 OxElFFFF のテキスト画面（テキスト 0) 

• 2 OxE 20000 ~ 0 xE 3 FFFF のテキスト画面（テキスト 1) 

• 4 OxE 4000〇〜 0 xE 5 FFFF のテキスト画面（テキスト 2) 

• 8 OxE 6000〇〜 0 xE 7 FFFF のテキスト画面（テキスト 3) 

_ iocs _ tcolor 関数は IOCS コール 0 x 15 を発行することによって処理される。 
戻り値一なし。 

規 格 —— XC 
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■ocs 一 textfiet 


用 途——テキスト画面からデータを読み込む。 

書 式- #include < sys / iocs . h > 

void 一 iocs_textget (int x , int y , struct _fntbuf * buff ); 

解 説一 _ iocs_text get 関数は，ズおよび夕で指定したテキスト画面の任意の座標から， 

パターンデータを読み込み，結果をゐ w # で 指定した バッファ 領域に格納する。 

には スーパー バイザ空間も指定できるので，誤ったアドレスを指定してはな 
らない 0 また，わげに指定する _ fntbuf 構造体には読み込む X 方向， Y 方向の 
ドット数を short で指定する。 

もし， _ fntbuf 構造体に入らないサイズを指定する場合は，独自に malloc 関数な 
どを使って領域を確保すること。如#に指定する - fntbuf 構造体は次のとおり 0 

struct _ fntbuf i 

short xl; /* 処理する X 方向のドット数 */ 

short yl; /* 処理する Y 方向のドット数 */ 

unsigned char buffer [72]; /* 読み込みバッファ */ 

}； 

_ iocs _ textget 閨数は IOCS コール OxlA を発行することによって処理される。 

戻り値-なし。 

規 格 — XC 

関連項目- _ iocs _ textput , malloc 
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joes—textput 


用 途ーテキスト画面にデータを書き込む。 

备式- #include < sys/iocs . h > 

void _ iocs_textput (int x , int y , const struct _fntbuf * buff ); 

解 説- - iocs_textput 関数は，ズおよび夕で指定したテキスト画面の任意の座標から 

ろで指定したパターンデータを書き込む。 

ゐげにはスーパーバイザ空間も指定できるので，誤ったアドレスを指定してはな 
らない 0 また，如#に指定する- fntbuf 構造体には書き込む X 方向， Y 方向の 
ドット数，およびパターンデータを short 型で指定する。 

もし， -fntbuf 構造体に入らないサイズを指定する場合は，独自に malloc 関数な 
どを使って領域を確保すること。如#に指定する .fntbuf 構造体は次のとおり。 

struct _fntbuf { 

short xl; /* 処理する X 方向のドット数 */ 

short yl; /* 処理する Y 方向のドット数 */ 

unsigned char buffer [72]; /* 軎き込みバッファ */ 

>； 

_ iocs_textput 関数は IOCS コール OxlB を発行することによって处理される。 

戻り値-なし。 

規 格 — XC 

関連項目- _ iocs _ textget , malloc 
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—locs—tgusemd 


用 途一画面モードを設定/取得する。 

式- #mclude < sys/iocs . h > 

mt _ iocs_tgusemd unt text _ gr , int mode ); 

解 説—— - iocs - tgusemd 関数は， tocL ” •で指定した画面の 画面モー ドを取得/設定する 0 

対象とする画面がグラフィック画面 （ OxCOOOOO 〜 OxDEFFFF ) ならば0を，テキス 
卜画面 （ OxE 4 000〇〜 0 xE 7 FFFF ) ならば1をに指定する。 

mode には〇〜 3あるいは 一1 を指定できる。それぞれの意味は次のとおり。 

•0 誰も使用していない 

• 1 システムで使用（ソフトキー/電卓/ RAM - DISK ) 

•2 アプリケーションで使用中 

• 3 アプリケーションで使用し，破壊されたまま 

•一1 画面モードの取得 

_ iocs _ tgusemd 関数は IOCS コール OxOE を発行することによって处理される。 
戻り値——設定前の画面モードを返す。 

規 格一 XC 
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• ssssssss 

• pirnniTTirTirnTnin 

• hhhhhhhh 


ゴみには文字列を格納するバッファの先頭アドレスを指定するが，このバッファ 
は最低9バイト以上の領域を確保しなければならない。また，このアドレスには 
スーパー バイ ザ 領域も指定できるので注意すること。 

_ iocs_timeasc 関数は IOCS コール 0 x 5 B を発行することによって処理される 0 
戻り値——失敗した場合は一1を返す。 

規格 —— XC 



—iocs—timeasc 


用 途——時刻を表す2進数形式のデータを文字列に変換する。 

fc xi - ffmclude < sys / iocs . h > 

mt _ iocs_timeasc vmt time , char * addr ); 

解説—— _ iocs_timeasc 関数は，">狀で指定した 2 進数形式の時刻データを 
の形式に変換し， a ゴみで指定した領域へ格納する。 

time に指定するビツトフイールドの内容は次のとおり。 

00000000 hhhhhhhh mmmmmmmm SSSSSSSS 


9 9 3 
5 5 2 

一 一 ^ 

〇 〇 〇 
〇 〇 〇 

/ 1 \ /\ /(\ 

秒分時 
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• ViVihhhhhh 

• TTITTITTITTITTlITITTITn 

• ssssssss 


_ iocs_timebcd 関数は IOCS コール 0 x 52 を発行することによつて处理される。 

戻り値——成功した場合は次のようなビットフィールドで返し，失敗した場合は負の値を返 
す。分/秒はいずれも BCD 2 桁である。 

0000 TTTT HHHHHHHH MMMMMMMM SSSSSSSS 

• SSSSSSSS 秒 （00 〜 59 ) 

• MMMMMMMM 分 （00 〜 59) 

• HHHHHHHH 時 （00 〜 23) 

• TTTT 1なら24時間計であることを示す 

規 格—— XC 
関連項目- _ iocs_timeset 


_iocstimebcd 


用 途——2進数の時刻を内部時計にセットできる形式に変換する。 

書 式- # include < sys / iocs . h > 

int _ iocs_timebcd (int time ;; 

解 説—— _ iocs _ timebcd 関数は， r / we で指定した 2 進数形式の時刻を， - iocs _ timeset 関 

数で使用できる形式に変換する。 

time に指定するビットフイールドの内容は次のとおり。 

00000000 lilihhhhhh mmmmmnimm SSSSSSSS 


\—/ \~/ ヽ —/ 

3 9 9 
2 5 5 

~ ~ ~ 

〇 〇 
〇 〇 

時分秒 
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• ssssssss 

• MMMMMMMM 

• HHHHHHHH 


• SSSSSSSS 

• MMMMMMMM 

• HHHHHHHH 



_ iocs _ timebiii 関数は IOCS コール 0 x 5 7 を発行することによって処理される。 
戻り値 一 次のようなビットフィールドを返す。分/秒はいずれも 2 進数である。 
00000000 HHHHHHHH MMMMMMMM SSSSSSSS 


—iocs—timemn 


用 途一時刻を BCD 形式から2進数形式へ変換する。 

書 式 - #include <sys/iocs.h> 

int _iocs_timebin ^mt time); 

解 説 —— _iocs_timebin 関数は汾從の時刻データを BCD 形式から 2 進数形式へ変換する。 

r / wd こ指定するビットフィールドの内容は次のとおり。分/秒はいずれも BCD 2 
桁である。 

00000000 HHHHHHHH MMMMMMMM SSSSSSSS 


\^/ \^/ \/ 

9 9 3 
5 5 2 

~ ~ ^ 

〇 〇 
〇 〇 

/—\ /(\ 

秒分時 


9 9 3 
5 5 2 

~ ~ ~ 

〇 〇 〇 
〇 〇 〇 

/ — \ / — \ /—\ 

秒分時 
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_iocs_timecnv 


用 途一時刻を表す文字列を2進数形式に変換する。 

書 瓦- #include < sys/iocs . h > 

int _ iocs_timecnv (const char * addr ); 

解 説—— . iocs . timecnv 関数は， 0 ゴみで指定した文字列を 2 進数形式の時刻データへ変換 

する。 

0ゴみには時刻を表す文字列の先頭アドレスを指定するが，このアドレスにはスー 
パーバイザ領域も指定できるので注意すること。 

文字列はの形式で指定する。時刻の区切り記号は“:”でも，それ以 
外でもよい。 

_ iocs _ timecnv 関数は IOCS コール 0 x 59 を発行することによって处理される。 

戻り値——成功した場合は次のようなビットフィールドを返し，失敗した場合は負の値を 
返す。 

00000000 hhhhhhhh mmmmmmmm SSSSSSSS 

• ssssssss 秒 (00 ~ 59) 

• mmmmmmmm 分（〇〇〜 59) 

• hhhhhhhh 時 （00 〜 23) 

規 格- XC 
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用 途 - 内部時計から時刻を読み込む。 

式 - #include <sys/iocs .h> 

mt _iocs_timeget (void); 

解 説 - _iocs_timeget 関数は内部時計から現在の時刻を読み込む。 

_iocs_timeget 関数は IOCS コール 0x56 を発行することによって処理される。 

戻り値 —— 次のようなビットフィールドを返す。分/秒はすべて BCD 2 桁である。 

0000 TTTT HHHHHHHH MMMMMMMM SSSSSSSS 


• HHHHHHHH 


• SSSSSSSS 


• MMMMMMMM 


秒 （ 00 〜 59) 
分 （ 00 〜 59) 
時 （ 00 〜 23) 


• TTTT 


1 なら 24 時間計であることを示す 


規 格 — XC 
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jocs— timerdst 


用 途—— MFP の TIMER - D による割り込みを設定する。 


書 式 - #include <sys/±ocs .h> 

int _iocs_timerdst (const void *addr, mt mode,int cnt); 


解 説一 _ iocs _ timerdst 関数は MFP の TIMER - D 割り込みを設定する。似/みには割り込み 
趄理アドレスを指定するが，0を指定することで割り込みを禁止できる。 

mode [こ は次の値を指定する 0 

• 1 1バ秒単位 

• 2 2.5 〆 秒単位 

•3 4#秒単位 

• 4 12.5 パ秒単位 

• 5 16パ秒単位 

• 6 25 “ 秒単位 

• 7 50 n 秒単位 

c / if には， TIMER - D 割り込みが何回ごとに設定した処理を行うかを，回数（〇〜 
255) で指定する。つまり， mo みで指定される割り込み周期にを乗じた単位 
で，割り込み処理が行われる。 

_ iocs _ timerdst 関数は IOCS コール 0 x 6 B を発行することによって处理される。 

戻り値——割り込みが設定された場合は0を返し，すでに使用している場合は〇以外の値を 
返す。 


注 意—— Human 68 k の動作中は割り込みを変更できない。 

規 格 —— XC 
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iocs—timeset 


用 途—内部時計に時刻を設定する。 

■rf it - #mclude < sys/iocs . ii > 

void _ iocs_timeset (mt time ；; 

解 説- _ iocs_timeset 関数は， "we で指定した時刻を内部時計に設定する 。 time の内容 

は- iocsjtimebcd 関数の戻り値を参照のこと。 

_ iocs_timeset 関数は10 CS コール 0 x 53 を発行することによって处理される。 

戻り値-なし。 

規 格 — XC 

関連項目- _ iocs_timebcd 
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—iocs—tpalet 


用 途—テキストパレットを設定する。 

書 瓦 - #include <svs/iocs .h> 

int _iocs_tpalet (mt no, int code); 

解 説一 _iocs_tpalet 関数は， no (0 - 15) で指定したテキストパレットを〇?办で指定 
した カラーに 設定する。 

/K? で指定するテキストパレット番号のうち，〇〜 3 はテキストの表示色， 4 〜 7 
はソフトキーボード/電卓の表示色その 1 (4 〜7 は同じコードを セット）， 8 〜 I 5 
はソフトキーボード/電卓の表示色その 2 (8 〜 15 は同じコードをセット）であ 
る。^7が属する範囲内のテキストパレットは全て同じカラーに設定される。 

⑺みには〇〜 65536 までの値を指定するが，一 1 を指定するとパレットの読み出 
しを行うことができ，また一2を指定するとパレットをシステム規定値に戻すこ 
とができる。 

_iocs_tpalet 関数は IOCS コール 0x13 を発行することによって処理される。 
戻り値——⑺みに 一 1を指定したときだけ，⑽で指定したパレットの設定値を返す。 

規 格一 XC 
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—iocs—tpalet2 


用 途ーテキストパレットを設定する。 

•rf 式- #include < sys / iocs . h > 

int _ iocs _ tpalet 2 (int no , int code ); 

解 説一 _ iocs _ tpalet 2 関数は， no {0 ~15) で指定したテキストパレットをみで指定 

したカラーに設定する。 _ iocs _ tpalet 2 関数は- iocs _ tpalet 関数とは異なり，0 
〜15のテキストパレットそれぞれを自由に設定することができる。 

code には〇〜 65536までの値を指定するが， 一 1を指定するとパレットの読み出 
しを行うことができ，また一2を指定するとパレットをシステム規定値に戻すこ 
とができる。 

_ iocs _ tpalet 2 関数は IOCS コール 0 x 14 を発行することによって処理される。 
戻り値——⑺みに一1を指定したときだけ，肋で指定したパレットの設定値を返す。 

規 格 — XC 
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jocs— trapi 


用 途——内部割り込み （trap #15) を直接実行する。 

書 式- # include < sys/iocs . h > 

int _ iocs _ traplt > (const struct _regs * mregs , 
struct _regs * outregs ); 

解 説- _ iocs _ trapl 5 関数は， / we 供で指定した _ regs 構造体のデータを各レジスタに複 

写し，直接 trap #15を実行する 。 trap #15実行後，各レジスタの内容を⑽/作取 
で指定した _ regs 構造体へ複写する。 inregs , ⑽かど取に指定する _ regs 構造体は 
次のとおり。 

struct _regs { 

int dO; /* 実行時の各データレジスタに対応 */ 

int dl; 

int d2; 

int d3; 

int d4; 

int d5; 

int d6; 

int d7; 

int al;/* 実行時の各アドレスレジスタに対応 */ 

int a2; 

mt a3; 

int a4; 

int a5; 

int a6; 

>； 


通常 ， trap #1 5 命令は IOCS コールを発行するために用いられるので ， inregs 
のメンバ dO に IOCS コール番号を設定し，それ以外のメンバに必要な値を設定 
してから」 • ocs — trapl 5 関数を実行すると，直接 IOCS コールを発行することが 
できる。ただし，かび供に対して誤った値を設定すると暴走する可能性があるの 
で十分に注意して使用すること。 

戻り値 —— trap #15命令実行後の dO レジスタの値を返す。 

規 格- XC 
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iocs—tvctrl 


用 途——専用テレビを操作する。 

書式- #mclude < sys / iocs . h > 

void _ iocs_tvctr 丄 （mt code ;; 

解 説—— _ iocs _ tvctrl 関数は，専用テレビに a ? みで指定したコマンドを送信し，専用テ 
レビのコントロールを 行う。 

code に指定するコマンドは次のとおり。 


• 0x01 

ボリュームを上げる 

• 0x02 

ボリュームを下げる 

• 0x03 

ボリュームを標準にする 

• 0x04 

チャンネルコール 

• 0x05 

テレビ画面（初期化 y リセット） 

• 0x06 

音声ミュート 

• 0x07 

電源 ON 

• 0x08 

テレビ，コンピュータ 

• 0x09 

テレビ，外部，コンピュータノー 

• OxOA 

コントラスト標準 

• 0x0B 

チャンネルアップ 

• 0x0C 

チャンネルダウン 

• 0x0D 

電源 OFF 

• OxOE 

電源 ON/OFF 

• OxOF 

スーパー 1 

• 0x10 

チャンネル 1 

• 0x11 

チャンネル 2 

• 0x12 

チャンネル 3 

• 0x13 

チャンネル 4 

• 0x14 

チャンネル 5 

• 0x15 

チャンネル 6 

• 0x16 

チャンネル7 

• 0x17 

チャンネル8 

• 0x18 

チャンネル 9 

• 0x19 

チャンネル 10 

• OxlA 

チャンネル 11 

• OxlB 

チャンネル 12 

• OxlC 

テレビ画面 (0x05) 

• OxlD 

コンピュータ画面 (0x05+0x08) 


マル， 


スーパー 
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• OxlE スーパー 1 (0 x 05+0 x 0 F ) 

• OxlF スーパー 2 (0 x 05+0 x :0 F +0 x 0 A ) 

• 0 x 21 〜 0 x 3 F 電源を入れた後，上記コマンドを実行 （0 x 20+0 x 01 〜 OxlF ) 
_ iocs _ tvctrl 関数は IOCS コール OxOC を発行することによって処理される。 

戻り値一なし。 

規 格 — XC 
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—locstxbox 


用 途——テキスト画面にボックスを描画する。 


書式- #mclude < sys / iocs . h > 

void _ iocs_txbox 、const struct _tboxptr * ptr ); 

解 説- _ iocs _ txbox 関数はテキスト画面にボックスを描画する。 p ひに指定する - tboxptr 

構造体は次のとおり。 


struct _tboxptr { 


>； 


unsigned short vram_page; 
short x; 
short y; 
short xl; 


/* テキストページ */ 
/* 始点の X 座標 */ 
/* 始点の Y 座標 */ 
/* 終点の X 座標 */ 


short yl; /* 終点の Y 座標 */ 

unsigned short line.style; /* ラインスタイル */ 


_ iocs _ txbox 関数は IOCS コール 0 xD 6 を発行することによって处理される。 


戻り値一なし。 


規 格 —— XC 



717 






ライブラリー第 2 部 


Jocstxfill 


用 途——テキスト画面に塗りつぶしたボックスを描画する。 

書 式-# include <sys/iocs.h> 

void _iocs_txfill (const struct _txfillptr *ptr); 

解 説一 _iocs_txfill 関数はテキスト画面に塗りつぶしたボックスを描画する。/?ヶに指 
定する _txf illptr 構造体は次のとおり。 

struct _txfillptr { 

unsigned short vram.page; /* ァキストヘーン */ 
short x; /* 始点の X 座標 */ 

short y; /* 始点の Y 座標 */ 

short xl; /* 終点の X 座標 */ 

short yl; /* 終点の Y 座標 */ 

unsigned short fill_patn; /* 塗りつぶしパターン */ 

>； 

_iocs_txfill 関数は IOCS コール 0xD7 を発行することによって処理される。 
戻り値——なし。 

規 格 —— XC 
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」 ocs—txrascoy 


用 途——テキスト画面のラスタコピーを行う。 


書式- #mclude < sys / iocs . h > 

void _iocs_txrascDV (mt sr_dst,int copy, int mode；; 


解 説- _iocs_txrascpy 関数はテキスト画面のラスタコピーを行う。 

sr - dst にはソース乂 256+デイステイネーシヨンを指定する。各8ビツトは4ラス 
夕単位で指定すること。また，⑺少には4ラスタを1単位として計算したコピー 
ラスタ数を指定し， mo みにはコピーする画面とそのコピー方向を指定する。画 
面は同時に4面まで指定可能である。 

mo みに指定できる値の内容は次のとおり。 


ビット0 

テキスト0 

ビット1 

テキスト1 

ビット2 

テキスト2 

ビット3 

テキスト3 

ビット15 

コピー方向 （0 ニインクリメント， 


ニデクリメント） 

iocs _ txrascpy 関数は IOCS コール OxDF を発行することによって処理される。 


戻り値——なし。 
規 格 — XC 


■ 
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locstxrev 


用 途ーテキスト画面を反転する。 


書式 -# include く svs/iocs .h> 

void _iocs_txrev (const struct _trevptr *ptr); 


解 説 —— _io CS _txrev 関数はテキスト画面を反転する。 /7 びに指定する —trevptr 構造体は 

次のとおり。 


struct _trevptr { 

unsigned short vram_page; /* アキストぺージ */ 


short x; 
short y; 
short xi; 
short yl; 


/* 始点の X 座標 */ 
/* 始点の Y 座標 */ 
/* 終点の X 座標 */ 
/* 終点の Y 座標 */ 


_iocs_txrev 関数は IOCS コール 0xD8 を発行することによって処理される。 


民り値-なし。 


規 格 — XC 
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—iocs—txxlme 


用 途ーテキスト画面に水平方向のラインを描画する。 


^ ji - #mclude < sys / iocs . h > 

void _ iocs _ txx 丄 me (const struct _xlineptr * ptr ); 


解 説—— _ iocs_txxline 関数はテキスト画面に水平方向のラインを描画する。尸ぴに指定す 

る- xlineptr 構造体は次のとおり。 


struct _xlineptr { 

unsigned short vram_page; 
short x; 
short y; 
short xl; 


/* テキストページ */ 

/* 始点の X 座標*/ 

/* 始点の Y 座標*/ 

/* 終点までの X の長さ */ 


unsigned short line.style; /* フ 1 ンスタイノレ */ 


}； 


_ iocs_txxline 関数は IOCS コール 0 xD 3 を発行することによって处理される。 


戻り値——なし。 
規 格 — XC 
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用 

書 

解 


途-テキスト画面に華直方向のラインを描画する。 

式-# include < sys / iocs . h > 

void _ iocs_txylme (struct vlineptr * ptr ); 

説—— _ io CS _ t X yline 関数はテキスト画面に垂直方向のラインを描画する。 p かに指定す 
る _ylineptr 構造体は次のとおり。 

struct _ylmeptr { 


unsigned short vram_page; /* アキストページ */ 


/* 始点の X 座標 */ 

/* 始点の Y 座標 */ 

/* 終点までの Y の長さ */ 


short x; 
short v; 
short yl; 


unsigned short line_style; /* ラインスタイル */ 


>； 

_ iocs_txyline 関数は IOCS コール 0 xD 4 を発行することによって処理される。 


用 

書 

解 


戻り値——なし。 


規 格一 - XC 
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locs.vdispst 


用 途一垂直同期による割り込みを設定する。 

•rf 式'~— #mclude < sys/iocs . h > 

int _ iocs_vdispst (const void * addr , int mode , int cnt ); 

解 説一 _ iocs _ vdispst 関数は垂直同期割り込みを設定する。0ゴみには割り込み処理アド 

レスを指定するが，0を指定することで割り込みを禁止できる。 

mode に は次の内容を指定する。 

•0 垂直帰線期間をカウント 
• 1 垂直表示期間をカウント 

02/には，割り込みが何回ごとに設定した処理を行うかを，回数 （0 〜 255) で指 
定する。つまり，みで指定される割り込み周期に c がを乗じた単位で，割り込 
み处理が行われる。 

_ iocs _ vdispst 関数は IOCS コール 0 x 6 C を発行することによって处理される。 

戻り値——割り込みが設定された場合は〇を返し，すでに使用している場合は〇以外の値を 
返す。 

規 格 — XC 



723 





ライブラリー第 2 部 


—iocs—vpage 


用 途——グラフィック画面の表示ページを設定する。 

書 式- # include く sys / iocs . h > 

int _ iocs_vpage (mt mode ); 

解 説—— _ iocs _ vpage 関数はグラフィック画面の表示ページの設定を行う。 

mo みは表示ページを指定する。指定する値は次のとおり。それぞれ1で表示す 
ることを，0で表示しないことを表す。 


•ビット 0 

0 ページ 

•ビット 1 

1 ページ 

•ビット 2 

2 ページ 

•ビット 3 

3 ページ 


- iocs — vpage 関数は IOCS コール 0 xB 2 を発行することによって処理される。 
戻り値一成功した場合は0を返し，失敗した場合は次の値を返す。 

•一1 グラフィックは使用できない 

• -2 規定外のページを指定した 

• -3 指定したページは現在の画面モードでは設定できない 

規 格- XC 
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—iocs—window 


用 途——グラフィック画面のウィンドウを設定する。 


書式- #include < sys/iocs . n > 

int _ iocs_window (int sx , int sv , int ex , int ey ); 

解 説- - iocs_window 関数はグラフィック画面のウィンドウの設定を行う。灯，の;，の r ， 

びにはそれぞれウィンドウに設定する左上，右下の座標を指定するが，指定する 
座標は必ず sxSea :, 叫ざ ey の条件を満たさなければならない。いずれも〇〜 
1023の範囲で指定すること。 

_ iocs_window 関数は IOCS コール 0 xB 4 を発行することによって处理される。 


戻り値——成功した場合は0を返し，失敗した場合は次の値を返す。 

•-1 グラフィックは使用できない 

• -2 規定外の引数を指定した 


規 格 — XC 
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—iocs—wipe 


用 途——グラフィック画面を消去する。 

書 式- #include < sys/iocs . h > 

int _ iocs_wipe 、 void ); 

解 説—— _ iocs _ wipe 関数はグラフィック画面を消去する。 

. iocs . wipe 関数は IOCS コール 0 xB 5 を発行することによって処理される。 

戻り値一成功した場合は0を返し，失敗した場合は次の値を返す。 

•-1 グラフィックは使用できない 

規 格 — XC 


726 







Chapter 4 


マルチバイト文字ライブラリ 


本章にはマルチバイト文字ライブラリのマニュアルを掲載します 。 LIBC 
では MS - C 7.0 と 同等のマルチバイト文字関数群を提供しています。 

ただし，これらのマルチバイト文字関数群はロケールに関してのサボー 
卜を一切しておらず，単にシフト JIS 文字コードに対するサボートにと 
どめています。なぜならば A / V 57 (7 において，マルチバイト文字は規定 
されてはいるものの，実際の関数レベルではほとんどサボートされてい 
ないのが現状だからです。 

ではマルチバイトへのアプローチとして，と りあえ f MS-C 7.0 
互換の環境を提供します。よくマニュアルを読んで使用してください。 
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ismobalnum 


用 途——半角英数字/半角カタカナかどうかを調べる。 

書 式- #include < mbctype . il > 

int ismbba 丄 num ^mt c ); 

#include < ictype . h > 
int isalnmkana (int c ); 

解 説—— ismbbalnum 関数は c で指定した文字コードが，半角英数字あるいは半角カタカ 
ナかどうかを調べる。結果は isalnum かつ ismbbkalnum 。 

戻り値—— c が半角英数字か半角カタカナならば0以外の値を返し，異なれば0を返す。 

注 意一ごは int 型の引数だが，その値は unsigned char 型で表現できる範囲の値かある 
いは EOF と同値でなければならない。この範囲を越える部分については，その動 
作は未定義である。 

通常， ismbbalnum 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定 
義されると実体をもつ関数となる。 ismbbalnum 関数がマクロとして展開される 
場合は，引数が副作用を伴わないように注意すること。 

ismbbalnum 関数はシフト JIS コードを扱うためのものであり，ロケールとは関 
係がない。 

互換性—— isalnmkana 関数は ismbbalnum 関数に対する別名である。 もしも XC や MS-C 6.0 
に対する互換性が必要ならば， isalnmkana 関数を使用すること。 

規 格一 - Project LIBC Group ， MS - C 7.0 

関連為目- lsmbbalpha , ismbbgraph , ismbbkalrmm , ismbbkana , ismbbkpunct , 

ismbblead , ismbbprint , ismbbpunct , ismbbtrail 
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Chapter 4 ■—マルチバイト文字ライブラリ 


ismbbalpha 


用 途——半角英字/半角カタカナかどうかを調べる。 

式- #include <mbctype . h > 

mt ismbbalpha kint c ); 

#include < jctype . h > 
int isalkana (int c ); 


解 説一 ismbbalpha 関数は c で指定した文字コードが，半角英字あるいは半角カタカナ 

かどうかを調べる。結果は is alpha かつ ismbbkalnum 。 

戻り値—— c が半角英字か半角カタカナならば0以外の値を返し，異なれば0を返す。 

注 意—— c は int 型の引数だが，その値は unsigned char 型で表現できる範囲の値かある 

いは EOF と同値でなければならない。この範囲を越える部分については，その動 
作は未定義である。 

通常， ismbbalpha 関数はマクロとして定義されるが， __ N 0_ CTYPE - INLINE — が定 
義されると実体をもつ関数となる。 ismbbELlpha 関数がマクロとして展開される 
場合は，引数が副作用を伴わないように注意すること。 

ismbbalpha 関数はシフト JIS コードを扱うためのものであり，ロケールとは関 
係がない。 



互換性一 isalkana 関数は ismbbalpha 関数に対する別名である。もしも XC や MS - C 6.0 
に対する互換性が必要ならば， isalkana 関数を使用すること。 


規 格 —— Project LIBC Group ， MS - C 7.0 

関連項目 - ismbbalnum, ismbbgraDh, ismbbkalnum, ismbbkana ， ismbbkpunct ， 

ismbblead, ismbbprint ， ismbbpunct, ismbbtrail 
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ライブラリー第 2 部 


ismbngraph 


用 途——半角スペース以外の表示可能文字かどうかを調べる。 

書式-# include <mbctype . h > 

int ismbbgraDn 、int c ); 

#include < jctype . h > 
int isgrkana (int c ); 

解 説—— ismbbgraph 関数は c で指定した文字コードが，半角スペース以外の表示可能文 
字（半角カナ文字を含む）かどうかを調べる。 

戻り値—— c が半角スペース以外の表示可能文字ならば0以外の値を返し，異なれば0を 
返す。 . 

注 意- c は int 型の引数だが，その値は unsigned char 型で表現できる範囲の値かある 

ぃは EOF と同値でなければならない。この範囲を越える部分につぃては，その動 
作は未定義である。 

通常， ismbbgraph 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定 
義されると実体をもつ関数となる。 ismbbgraph 関数がマクロとして展開される 
場合は，弓 I 数が副作用を伴わなぃように注意すること。 

i smbbgraph 関数はシフト JIS コードを扱うためのものであり，ロケールとは関 
係がない。 


互換性—— isgrkana 関数は ismbbgraph 関数に対する別名である。もしも XC ^ MS - C 6.0 
に対する互換性が必要ならば， isgrkana 関数を使用すること。 

規 格 —— Project LIBC Group ， MS - C 7.0 

関埋項目- lsmbbalnum ， ismbbalpha , ismbbkalnum , ismbbkana , ismbbkpunct , 

ismbblead ， ismbbprint , ismbbpunct , ismbbtrail 
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Chapter 4 —マルチバイト文字ライブラリ 


ismbDkalnum 


用 途——半角カタカナかどうかを調べる。 


僅 エく- #mclude く mbctvpe . li > 

int ismbbkalnum 、int c ); 
#mclude < ■) ctype . h > 
int iskmoji (int c ); 


解 説- ismbbkalnum 関数は c で指定した文字コードが，半角カタカナ（半角カナ記号は 

含まない）かどうかを調べる。 

戻り値一 c が半角カタカナならば0以外の値を返し，異なれば0を返す。 

注 意- C は int 型の引数だが，その値は unsigned char 型で表現できる範囲の値かある 

いは EOF と同値でなければならない。この範囲を越える部分については，その動 
作は未定義である。 

通常， ismbbkaln 皿関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が 
定義されると実体をもつ関数となる。 ismbbkalnum 関数がマクロとして展開され 
る場合は，引数が副作用を伴わないように注意すること。 

ismbbkalnum 関数はシフト JIS コードを扱うためのものであり，ロケールとは関 
係がない。 



互換性- iskmoji 関数は ismbbkalnum 関数に対する別名でる。もしも XC や MS - C 6.0\: 

対する互換性が必要ならば， iskmoji 関数を使用すること。 


規 格一^ Project LIBC Group ， MS - C 7.0 

関連項目- ismbbalnum , ismbbalpha ， ismbbgrapti ， ismbbkana ， ismbbkpunct , ismbblead , 

ismbbprint , ismbbpunct , ismbbtrail 
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ライブラリー第 2 部 


■smbbkana 


用 途——半角カナ文字かどうかを調べる。 

書 式 '— -#include <mbctype . h > 

int lsmbbkana (mt c ); 

#include < jctype . h > 
int iskana (int c ); 

解 説—— ismbbkana 関数は c で指定した文字コードが，半角カナ文字（半角カナ記号と半 
角カタカナ OxAl 〜 OxDF ) かどうかを調べる。 

戻り値—— C が半角カナ文字ならば0以外の値を返し，異なれば0を返す。 

注 意—— c は int 型の引数だが，その値は unsigned char 型で表現できる範囲の値かある 
いは EOF と同値でなければならない。この範囲を越える部分に ついては， その動 
作は未定義である。 

通常， ismbbkana 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定 
義されると実体をもつ関数となる。 ismbbkana 関数がマクロとして展開される場 
合は，引数が副作用を伴わないように注意すること。 

ismbbkana 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係 
がない。 

互換性一 iskana 関数は ismbbkana 関数に対する別名である。もしも XC や MS - C 6.0 に 
対する互換性が必要ならば， iskana 関数を使用すること。 

規 格- Project LIBC Group , MS-C 7. 0 

関連 I 貝目 ismbbalnum , ismbbalpha , ismbbgraph , ismbbkalnum , ismbbkp 皿 ct ， 

ismbblead , ismbbprint , ismbbpiinct , ismbbtrail 
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Chapter 4 —マルチバイト文字ライブラリ 


ismbbkpunct 


用 途一半角カナ記号かどうかを調べる。 

■rf 式 - frinc 丄 ude <mbctype .h> 

mt ismDbkpunct (mt c); 

#include <jctype.h> 
int iskpun (int c); 

解 説- ismbbkpunct 関数は c で指定した文字コードが，半角カナ記号かどうかを調べる。 

戻り値—— c が半角カナ記号ならば0以外の値を返し，異なれば0を返す。 

注 意- C •は int 型の引数だが，その値は unsigned char 型で表現できる範囲の値かある 

いは EOF と同値でなければならない。この範囲を越える部分については，その動 
作は未定義である。 

通常， ismbbkpunct 関数はマクロとして定義されるが， —NO_CTYPE_INLINE__ が 
定義されると実体をもつ関数となる。 ismbbkpunct 関数がマクロとして展開され 
る場合は，引数が副作用を伴わないように注意すること。 

ismbbkpunct 関数はシフト JIS コードを扱うためのものであり，ロケールとは関 
係がない。 



互換性—— iskpun 関数は ismbbkpunct 関数に対する別名である。もしも XC や MS - C 6.0 
に対する互換性が必要ならば， iskpun 関数を使用すること。 


規 格 —— Project LIBC Group , MS - C 7.0 


関連項目——- ismbbalnum , ismbbalpha , ismbbgraph ， ismbbkalnum ， ismbbkana , ismbb 丄 ead ， 
ismbbprint , ismbbpunct , ismbbtrail 
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ライブラリ ー 第2部 


ismbbiead 


用 途一全角文字の第1バイトかどうかを調べる。 

書式- #include <mbctype . h > 

int ismbbiead ^mt c); 

#include <jctype.h> 
int iskanji ^mt c); 

解 説一 ismbbiead 関数は c で指定した文字コードが，シフト JIS 全角文字の第1バイト 
(0 x 81 〜 0 x 9 F ， OxEO 〜 OxFC ) かどうかを調べる。 

戻り値—— c がシフト JIS 全角文字の第1バイトならば0以外の値を返し，異なれば0を 
返す。 

注 意—— c は int 型の引数だが，その値は unsigned char 型で表現できる範囲の値かある 
いは EOF と同値でなければならない。この範囲を越える部分については，その動 
作は未定義である。 

通常， ismbbiead 関数はマクロとして定義されるが， __NO_CTYPE_INLINE__ が定 
義されると実体をもつ関数となる。 ismbbiead 関数がマクロとして展開される場 
合は，引数が副作用を伴わないように注意すること。 

ismbbiead 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係 
がない。 

互換性—— iskanji 関数は ismbbiead 関数に対する別名である。もしも XC や MS - C 6.0 に 
対する互換性が必要ならば， iskanji 関数を使用すること。 

規 格 —— Project LIBC Group ， MS - C 7.0 

関連項目- ismbbalnum, ismbbalpha, ismbbgraph, ismbbkalnum, ismbbkana, 

ismbbkpunct, ismbbprint, ismbbpunct, ismbbtrail 

変 更-従来では ismbbiead 関数が真の値を返す値の範囲を 0x81 〜 0x9F, OxEO 〜 OxFC 

としていたが，現在のには 0x80 を追加した。 Human68k では， 0x80?? 
のコード部 FC 分に2バイト半角コードが割り当てられているためである。 
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Chapter 4 ーマルチバイト文字ライブラリ 


ismbbprint 


用 途——半角印字可能文字かどうかを調べる。 


書式- frinc 丄 ude <mbctype . h > 

mt ismbbprint ^mt c ); 

#include <j ctype . h > 
int isprkana (int c ); 

解 説一 ismbbprint 関数は c •で指定した文字コードが，半角印字可能文字かどうかを調 
ベる。結果は isprint かつ ismbbkana 。 

戻り値一 c が半角表示可能文字ならば0以外の値を返し，異なれば0を返す。 

注 意—— C は int 型の引数だが，その値は unsigned char 型で表現できる範囲の値かある 

いは EOF と同値でなければならない。この範囲を越える部分については，その動 
作は未定義である。 

通常， ismbbprint 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定 
義されると実体をもつ関数となる。 ismbbprint 関数がマクロとして展開される 
場合は，引数が副作用を伴わないように注意すること。 

ismbbprint 関数はシフト JIS コードを扱うためのものであり，ロケールとは関 
係がない。 

互換性 - isprkana 関数は ismbbprint 関数に対する別名である。もしも XC や MS-C 6.0 

に対する互換性が必要ならば， isprkana 関数を使用すること。 

規 格 —— Project LIBC Group 、 MS - C 7.0 

関連項目- ismbbalnum , ismbbalpha , ismbbgraph , ismbbkalnum ， ismbbkana , 

ismbbkpunct , ismbblead , ismbbpunct , ismbbtrail 
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ライブラリー第 2 部 


ismbbpunct 


用 途——半角記号/半角カナ記号かどうかを調べる。 

書 式- —# include <mbctype . h > 

int ismbbpunct (mt c ); 

#include < jctype . h > 
int ispnkana (int c ); 

解 説—— ismbbpunct 関数は c で指定した文字コードが半角記号または半角カナ記号かど 
うかを調べる。結果は ispunct かつ ismbbkpunct 。 

戻り値—— C が半角記号/半角カナ記号ならば 0 以外の値を返し，異なれば 0 を返す。 

注 意- c は int 型の引数だが，その値は unsigned char 型で表現できる範囲の値かある 

いは EOF と同値でなければならない。この範囲を越える部分については，その動 
作は未定義である。 

通常， ismbbpunct 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定 
義されると実体をもつ関数となる。 ismbbpunct 関数がマクロとして展開される 
場合は，弓 I 数が副作用を伴わないように注意すること。 

ismbbpunct 関数はシフト JIS コードを扱うためのものであり，ロケールとは関 
係がない。 

互換性—— ispnkana 関数は ismbbpunct 関数に対する別名である。もしも XC や MS - C 6.0 
に対する互換性が必要ならば， ispnkana 関数を使用すること。 

規 格- Project LIBC Group ， MS - C 7.0 

関連項目 ismbbalnum ， ismbbalpha , ismbbgraph , ismbbkalnum ， ismbbkana , 
ismbbkpunct , ismbblead , ismbbprint , ismbbtrail 
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Chapter 4 ーマルチパイト文字ライブラリ 


ismbDtrail 


用 途-全角文字の第2バイトかどうかを調べる。 

■rf ェて^ # inc 丄 ude < mbctype . h > 

mt ismbbtrail (int c ); 

#include < jctype . h > 
int iskanji 2 (int c ); 

解 説一 ismbbtrail 関数は c で指定した文字コードが，シフト JIS 全角文字の第2バイ 

卜 （0 x 40 〜 0 x 7 E , 0 x 80 〜 OxFC ) かどうかを調べる。 

戻り値—— c がシフト JIS 全角文字の第2バイトならば0以外の値を返し，異なれば0を 
返す。 



注 意—— c は int 型の引数だが，その値は unsigned char 型で表現できる範囲の値かある 

いは EOF と同値でなければならない。この範囲を越える部分については，その動 
作は未定義である。 

通常， ismbbtrail 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定 
義されると実体をもつ関数となる。 ismbbtrail 関数がマクロとして展開される 
場合は，引数が副作用を伴わないように注意すること。 

ismbbtrail 関数はシフト JIS コー ドを扱うためのものであり，ロケー ルと は関 
係がない。 

互換性—— iskanji 2 関数は ismbbtrail 関数に対する別名である。もしも XC や MS - C 6.0 
に対する互換性が必要ならば， iskanji 2 関数を使用すること。 

規 格 —— Project LIBC Group ， MS - C 7.0 

関連項目- ismbbalnum , ismbb alpha , ismbbgraph , ismbbka 丄 num ， ismbbkana , 

ismbbkpunct , ismbblead , ismbbprint , ismbbpunct 
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ライブラリー第 2 部 


ismbcalpha 


用 途——全角英字かどうかを調べる。 

書 式- #include <mbctype . h > 

int ismbcalpha (int c ); 

#inelude < jctype . h > 
int j is alpha ^mt c ); 

解 説—— ismbcalpha 関数は c で指定した文字コードが，全角英字 （0 x 8260 〜0 x 8279, 
0 x 8281 〜 0 x 829 A ) かどうかを調べる。 C は全角文字の第1バイトを上位8ビット 
に，第2バイトを下位8ビットに設定すること。 

戻り値—— c が全角英字ならば0以外の値を返し，異なれば0を返す。 

注 意——通常， ismbcalpha 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定 
義されると実体をもつ関数となる。 ismbcalpha 関数がマクロとして展開される 
場合は，引数が副作用を伴わないように注意すること。 

ismbcalpha 関数はシフト JIS コードを扱うためのものであり，ロケールとは閨 
係がない。 

互換性—— jisalpha 関数は ismbcalpha 関数に対する別名である。もしも XC や MS - C 6.0 
に対する互換性が必要ならば，： jisalpha 関数を使用すること。 

規 格—— Project LIBC Group , MS - C 7.0 

関連項目- ismbedigit , ismbehira , ismbekata , ismbelO , ismbcll , ismbcl 2, 

ismbclegal , ismbclower ， ismbeprint , ismbcspace , ismbesymbol , 
ismbeupper 
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Chapter 4 —マルチバイト文字ライブラリ 


ismbcaigit 


用 途——全角数字かどうかを調べる。 

•rf エぐ- #mclude <mbctvpe . h > 

int ismbcdigit tint c ); 

#include < jctype . h > 
int jisdigit (int c ); 

解 説—— ismbcdigit 関数は C で指定した文字コードが，全角数字 （0 x 824 F 〜 0 x 8258) か 
どうかを調べる。 c は全角文字の第1バイトを上位8ビットに，第2バイトを下 
位8ビットに設定すること。 

戻り値—— c が全角数字ならば0以外の値を返し，異なれば0を返す。 

注 意一通常， ismbcdigit 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定 
義されると実体をもつ関数となる。 ismbcdigit 関数がマクロとして展開される 
場合は，引数が副作用を伴わないように注意すること。 

ismbcdigit 関数はシフト JIS コードを扱うためのものであり，ロケールとは関 
係がない。 

互換性—— jisdigit 関数は ismbcdigit 関数に対する別名である。もしも XC や MS - C 6.0 
に対する互換性が必要ならば， jisdigit 関数を使用すること。 

規 格 —— Project LIBC Group ， MS - C 7.0 

関連項目- ismbc alpha , ismbchira , ismbckata , ismbclO , ismbcll , ismbcl 2, 

ismbclegal , ismbclower , ismbcprint , ismbcspace ， ismbcsymbol , 
ismbcupper 
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ライブラリー第 2 部 


ismbchira 


用 途一全角ひらがなかどうかを調べる。 

書 式' # include < mbctype . h > 

int ismbchira ^mt c ); 

#include < jctype . h > 
int jishira (int c ); 

解 説—— ismbchira 関数は c で指定した文字コードが，全角ひらがな （0 x 829 F 〜 0 x 82 Fl ) 
かどうかを調べる。 c は全角文字の第1バイトを上位8ビットに，第2バイトを 
下位8ビットに設定すること。 

戻り値—— c が全角ひらがなならば0以外の値を返し，異なれば0を返す。 

注 意——通常， ismbchira 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定 
義されると実体をもつ関数となる。 ismbchira 関数がマクロとして展開される場 
合は，引数が副作用を伴わないように注意すること。 

ismbchira 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係 
がない。 

互換性一 jishira 関数は ismbchira 関数に対する別名である。もしも XC や MS - C 6.0\: 
対する互換性が必要ならば， jishira 関数を使用すること。 

規 格—— Project LIBC Group ， MS - C 7.0 

関連項目- ismbc alpha , ismbcdigit , ismbckata , ismbclO ， ismbcll , ismbcl 2, 

ismbclegal ， ismbclower ， ismbcprint , ismbcspace , ismbcsymbol ， 
ismbcupper 
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Chapter 4 ー マルチバイト文字ライブラリ 


ismbckata 


用 途一全角カタカナかどうかを調べる。 


■rf - #mclude <mbctype . h > 

mt ismbckata unt c ); 

#include < jctype . h > 
int jiskata (int c ); 

解 説一 ismbckata 関数は c で指定した文字コードが，全角カタカナ （0 x 8340 〜 0 x 8396) 

かどうかを調べる。 c は全角文字の第1バイトを上位8ビットに，第2バイトを 
下位8ビットに設定すること。 

戻り値一 C が全角カタカナならば0以外の値を返し，異なれば0を返す。 

注 意一通常， ismbckata 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定 
義されると実体をもつ関数となる。 ismbckata 関数がマクロとして展開される場 
合は，引数が副作用を伴わないように注意すること。 

ismbckata 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係 
がない。 



互換性—— jiskata 関数は ismbckata 関数に対する別名である。もしもや舰に 
対する互換性が必要ならば， jiskata 関数を使用すること。 

規 格 —— Project LIBC Group , MS - C 7.0 

関連項目- ismbc alpha , ismbcdigit , ismbchira , ismbclO ， ismbcll , ismbcl 2, 

ismbclegal , ismbclower ， ismbcprint , ismbcspace ， ismbcsymbol , 
ismbcupper 
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ライブラリー第 2 部 


ismbcIO 


用 途—— JIS 非漢字かどうかを調べる。 

書 式- # include < mbctype . h > 

mt ismbcIO (mt c ); 

#include < jctype . h > 
int jislO (int c ); 

解 説—— ismbcIO 関数は c で指定した文字コードが， JIS 非漢字 （0 x 8140 〜 0 x 889 E ) かど 

うかを調べる。 C は全角文字の第1バイトを上位8ビットに，第2バイトを下位 
8ビットに設定すること。 

戻り値—— c が JIS 非漢字ならば0以外の値を返し，異なれば0を返す。 

注 意——通常， ismbcIO 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義 
されると実体をもつ関数となる。 ismbcIO 関数がマクロとして展開される場合は， 
引数が副作用を伴わないように注意すること。 

ismbcIO 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係が 
ない0 

互換性—— jislO 関数は ismbcIO 関数に対する別名である。もしも XC 7 や舰 S - C 反0に対す 
る互換性が必要ならば，： jislO 関数を使用する。 

規 格^— Project LIBC Group , MS - C 7.0 

関連項目 ismbc alpha , ismbcdigit , ismbchira ， ismbckata , ismbcll ， ismbcl 2, 

ismbclegal ， ismbclower , ismbcprint , ismbcspace , ismbcsymbol , 
ismbcupper 
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Chapter 4 ーマルチバイト文字ライブラリ 


ismbcll 


用 途—— JIS 第1水準漢字かどうかを調べる。 

書 式- - #mclude <mbctype .h> 

int ismbcll unt c ノ； 

#include <jctype.h> 
int jisll (int c); 

解 説 —— ismbcll 関数は C で指定した文字コードが， JIS 第 1 水準漢字 (0X889F ~ 0x9872) 

かどうかを調べる。 c は全角文字の第1バイトを上位8ビットに，第2バイトを 
下位8ビットに設定すること。 



戻り値—— c が JIS 第1水準漢字ならば0以外の値を返し，異なれば0を返す。 


注 意一通常， ismbcll 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義 
されると実体をもつ関数となる。 ismbcll 関数がマクロとして展開される場合は， 
弓 I 数が副作用を伴わないように注意すること。 

ismbcll 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係が 
ない0 


互換性—— jisll 関数は ismbcll 関数に対する別名である。もしもやぢに対す 
る互換性が必要ならば， jisll 関数を使用すること。 

規 格 —— Project LIBC Group ， MS - C 7.0 

関連項目- ismbc alpha , ismbcdigit , ismbchira , ismbckata ， ismbclO ， ismbcl 2, 

ismbclegal , ismbclower , ismbcprint , ismbcspace ， ismbcsymbol , 
ismbcupper 


743 






ライブラリー第 2 部 


ismbclz 


用 途—— JIS 第2水準漢字かどうかを調べる。 

書 式- # include <mbctype . h > 

mt ismbcl 2 ^mt c ); 

#include <j ctype . h > 
int jisl 2 (int c ); 

解 説—— ismbcl 2 関数は c で指定した文字コードが， JIS 第2水準漢字 （0 x 989 F 〜 0 xEA 9 E ) 

かどうかを調べる。 C は全角文字の第1バイトを上位8ビットに，第2バイトを 
下位8ビットに設定すること。 

戻り値一 c が JIS 第2水準漢字ならば0以外の値を返し，異なれば0を返す。 

注 意——通常， ismbcl 2 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義 

されると実体をもつ関数となる。 ismbcl 2 関数がマクロとして展開される場合は， 
引数が副作用を伴わないように注意すること。 

ismbcl 2 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係が 
ない0 

互換性—— jisl 2 関数は ismbcl 2 関数に対する別名である。もしも XC やに対す 
る互換性が必要ならば，： jisl 2 関数を使用すること。 

規 格—— Project LIBC Group ， MS - C 7.0 

関埋項目- ismbc alpha , ismbcdigit , ismbchira , ismbckata ， ismbclO , ismbcll ， 

ismbclegal , ismbclower , ismbcprint , ismbcspace , ismbcsymbol , 
ismbcupper 
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Chapter 4 ーマルチパイト文字ライブラリ 


ismocleqal 


用 途——正しいシフト JIS 全角文字かどうかを調べる。 

書式- frmclude <mbctype . li > 

mt ismbclegal ^mt c ); 

#include < jctype . h > 
int jiszen (int c ); 

解 説一 ismbclegal 関数は c で指定した文字コードが，シフト JIS コードとして正しい 

かどうかを調べる。 c は全角文字の第1バイトを上位8ビットに，第2バイトを 
下位8ビットに設定すること。 

戻り値一 c が正しいシフト JIS 全角文字ならば0以外の値を返し，異なれば0を返す。 

注 意一通常， ismbclegal 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定 
義されると実体をもつ関数となる。 ismbclegal 関数がマクロとして展開される 
場合は，引数が副作用を伴わないように注意すること。 

ismbclegal 関数はシフト JIS コードを扱うためのものであり，ロケールとは関 
係がない。 

互換性—— jiszen 関数は ismbclegal 関数に対する別名である。もしも XC や MS - C 6.0 に 
対する互換性が必要ならば， jiszen 関数を使用すること。 

規 格 —— Project LIBC Group , MS - C 7.0 



関埋 I 貝目- ismbc alpha , ismbcdigit , ismbchira , ismbckata , ismbcIO ， ismbc 丄 1 ， 

ismbcl 2, ismbclower , ismbcprint , ismbcspace , ismbcsymbol , ismbcupper 







ライブラリー第 2 部 


ismbclower 


用 途——全角英小文字かどうかを調べる。 

書式-# include <mbctype . h > 

int ismbclower ^mt c ); 

#include <jctype 
int jislower ^mt c ); 

解 説—— ismbclower 関数は c で指定した文字コードが，全角英小文字 （0 x 8281 〜 0 x 829 A ) 
かどうかを調べる。 c は全角文字の第1バイトを上位8ビットに，第2バイトを 
下位8ビットに設定すること。 

戻り値一 c が全角英小文字ならば0以外の値を返し，異なれば0を返す。 

注 意一通常， ismbclower 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定 

義されると実体をもつ関数となる。 ismbclower 関数がマクロとして展開される 
場合は，引数が副作用を伴わないように注意すること。 

ismbclower 関数はシフト JIS コードを扱うためのものであり，ロケールとは関 
係がない。 

互換性—— jislowei •関数は ismbclower 関数に対する別名である。もしも XC や MS - C 6.0 
に対する互換性が必要ならば， jislower 関数を使用すること。 

規 格 —— Project LIBC Group , MS - C 7.0 

関連項日- ismbc alpha , ismbcdigit , ismbchira ， ismbckata , ismbc 丄0， ismbcli , 

ismbcl 2， ismbclegal , ismbcprint , ismbcspace ， ismbcsymbol , ismbcupper 
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Chapter 4 ー マルチバイト文字ライブラリ 


ismbcprint 


用 途一印字可能文字かどうかを調べる。 


式- ffinclude <mbctype . h > 

int ismbcprint 、int c ); 

#include < jctype . h > 
int jlsprint (int c ); 

解 説一 ismbcprint 関数は c で指定した文字コードが，印字可能文字（半角カナ文字，全 
角文字を含む）かどうかを調べる。結果は i sprint かつ iskana かつ ismbclegal 。 
C は全角文字の第1バイトを上位8ビットに，第2バイトを下位8ビットに設定 
すること。 

戻り値—— e が印字可能文字ならば0以外の値を返し，異なれば0を返す。 

注 意——通常， ismbcprint 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定 
義されると実体をもつ関数となる。 ismbcprint 関数がマクロとして展開される 
場合は，引数が副作用を伴わないように注意すること。 

ismbcprint 関数はシフト JIS コードを扱うためのものであり，ロケールとは関 
係がない。 

互換性—— jisprint 関数は ismbcprint 関数に対する別名である。もしも ZC や MS - C 6.0 
に対する互換性が必要ならば， jisprint 関数を使用すること。 



規 格一 Project LIBC Group ， MS - C 7.0 


関連項目- ismbc alpha , ismbcdigit , ismbchira , ismbckata ， ismbcIO ， lsmocll , 

ismbcl 2， ismbclegal , ismbc 丄 ower ， ismbcspace , ismbcsymbol , ismbcupper 
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ライブラリー第 2 部 


ismocspace 


用 途—全角スぺースかどうかを調べる。 

書式-# include <mbctyDe.ii> 

int ismbcspace (int c ); 

#include < jctype . h > 
int jisspace (int c ); 

解 説—— ismbcspace 関数は c で指定した文字コードが，全角スペース (0 x 8140) かどうか 

を調べる。 c は全角文字の第1バイトを上位8ビットに，第2バイトを下位8ビッ 
卜に設定すること。 

戻り値—— c が全角スペースならば0以外の値を返し，異なれば0を返す。 

注 意——通常， ismbcspace 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定 

義されると実体をもつ関数となる。 ismbcspace 関数がマクロとして展開される 
場合は，引数が副作用を伴わないように注意すること。 

ismbcspace 関数はシフト JIS コードを扱うためのものであり，ロケールとは関 
係がない。 

互換性—— jisspace 関数は ismbcspace 関数に対する別名である。もしも XC や MS - C 6.0 
に対する互換性が必要ならば， jisspace 関数を使用すること。 

規 格一 Project LIBC Group ， MS - C 7.0 

関連項日- ismbc alpha , ismbcdigit ， ismbchira , ismbckata , ismbc 丄0， ismbcli ， 

ismbcl 2, ismbclegal , ismbclower , ismbcprint , ismbcsymbol , ismbcupper 
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Chapter 4 —マルチバイト文字ライブラリ 


ismbcsymboi 


用 途——全角記号かどうかを調べる。 

書式- #mclude <mbctype . h > 

int ismbcsvmbol kint c ); 

#include < jctype . h > 
int jiskigou (int c ); 

解 説—— ismbcsymboi 関数は C で指定した文字コードが，全角記号 （0 x 8141 〜 0 x 81 AC ) 

かどうかを調べる。 c は全角文字の第1バイトを上位8ビットに，第2バイトを 
下位8ビットに設定すること。 

戻り値—— £* が全角記号ならば0以外の値を返し，異なれば0を返す。 

注 意——通常， ismbcsymboi 関数はマクロとして定義されるが， _ JJO _ CTYPE _ INLINE __ が 
定義されると実体をもつ関数となる。 ismbcsymboi 関数がマクロとして展開され 
る場合は，引数が副作用を伴わないように注意すること。 

ismbcsymboi 関数はシフト JIS コードを扱うためのものであり，ロケールとは関 
係がない。 

互換性—— jiskigou 関数は ismbcsymboi 関数に対する別名である。もしも XC や MS - C 6.0 
に対する互換性が必要ならば， jiskigou 関数を使用すること。 

規 格 —— Project LIBC Group , MS - C 7.0 

関連項目- ismbc alpha , ismbcdigit , ismbchira , ismbcKata , ismbcIO ， ismbcll , 

ismbcl 2, ismbclegal , ismbclower , ismbcprint , ismbcspace , ismbcupper 
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ライブラリー第 2 部 


ismbcupper 


用 途——全角英大文字かどうかを調べる。 

書式- #mc 丄 ude <mbctype . n > 

mt ismbcupper、int c ); 

#include < jctype . h > 
int jisupper (int c ); 

解 説—— ismbcupper 関数は c で指定した文字コードが，全角英大文字 （0 x 8260 〜 0 x 8279) 

かどうかを調べる。 c は全角文字の第1バイトを上位8ビットに，第2バイトを 
下位8ビットに設定すること。 

戻り値—— C が全角英大文字ならば0以外の値を返し，異なれば0を返す。 

注 意——通常， ismbcupper 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定 
義されると実体をもつ関数となる。 ismbcupper 関数がマクロとして展開される 
場合は，弓 I 数が副作用を伴わないように注意すること。 

ismbcupper 関数はシフト JIS コードを扱うためのものであり，ロケールとは関 
係がない。 

互換性一 jisupper 関数は ismbcupper 関数に対する別名である。もしも XC や MS - C 6.0 
に対する互換性が必要ならば，： jisupper 関数を使用すること。 

規 格 —— Project LIBC Group , MS - C 7.0 

関埋生目- ismbc alpha , ismbcdigit , ismbchira , ismbckata , ismbclO , ismbcll , 

ismbcl 2， ismbclega 丄， ismbclower ， ismbcprint , ismbcspace , ismbcsymbol 
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Chapter 4 —マルチバイト文字ライブラリ 


mbbtombc 


用 途——半角文字を全角文字に変換する。 

書式- #mclude < mbstrmg . h > 

mt mbbtombc ^int c ); 

#include < jstring . h > 
int hantozen (int c ); 

解 説 —— mbbtombc 関数は c で指定した半角文字を，対応する全角文字に変換する。変換 
対象となるコードは 0 x 20 〜 0 x 7 E，OxAl 〜 OxDF であり，それ以外の文字は変化 
しない。 

戻り値—— C が変換可能ならばその変換結果を返し，不可ならば C をそのまま返す。 

注 意—— mbbtombc 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係 
がない。 

互換性- hantozen 関数は mbbtombc 関数に対する別名である 0 もしも XC や MS - C 6.0 に 

対する互換性が必要ならば， hantozen 関数を使用すること 0 

規 格- Project LIBC Group 、 MS - C 7.0 

関連項目- mbctombb 
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ライブラリー第 2 部 


mbbtype 


用 途——バイトデータの文字種を判別する。 

書 式- # include く mbstring . h 〉 

int mbbtvpe ^unsigned char c,int type); 

#include く jstring . h > 

int chkctype (unsigned char c , int type ); 

解 説—— mbbtype 関数は c で指定したバイトデータの文字種を判別し，その結果を返す。 

07が1以外の値を指定した場合は， c が半角文字かシフト JIS 全角文字の第1 
バイトかどうかを判別し，07が1ならば c がシフト JIS 全角文字の第2バイト 
かどうかを判別する。 

戻り値一•ひ/^が1以外の場合， c の文字種を返す。結果は次のマクロ値をとる。 

• MBC—SINGLE 半角文字 （0 x 20 〜 0 x 7 E , OxAl 〜 OxFC ) 

• MBC 丄 EAD シフト JIS 全角文字の第1バイト 

• MBC—ILLEGAL それ以外 ( null 文字を含む） 

type が1の場合， C の文字種を返す。結果は次のマクロ値をとる。 

• MBC-TRAIL シフト JIS 全角文字の第2バイト 

• MBC.ILLEGAL それ以外 （ null 文字を含む） 

注 意—— mbbtype 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係が 
ない。 

互換性—— chkctype 関数は mbbtype 関数に対する別名である。もしも XC や MS - C 6.0 に 
対する互換性が必要ならば， chkctype 関数を使用すること。 

規 格- Project LIBC Group , MS - C 7.0 

関連項目- mbsbtype 
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Chapter 4 —マルチバイト文字ライブラリ 


mbctohira 


用 途——全角カタカナを全角ひらがなに変換する。 

■rf 式- #include < mbstring . h > 

int mbctohira ^int c ); 

#include < jstring . h > 
int jtohira (int c ); 

解 説—— mbctohira 関数は c で指定された全角カタカナの文字コードを，全角ひらがなの 

文字コードに変換する。 c が全角カタカナでなかったり，変換できない場合は c 
をそのまま返す。 c は全角文字の第1バイトを上位8ビットに，第2バイトを下 
位8ビットに設定すること。 

戻り値—— c が変換可能ならばその変換結果を返し，不可ならば c をそのまま返す。 

注 意——通常， mbctohira 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定 
義されると実体をもつ関数となる。 mbctohira 関数がマクロとして展開される場 
合は，引数が副作用を伴わないように注意すること。 

mbctohira 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係 
がない。 

互換性一 jtohira 関数は mbctohira 関数に対する別名である。もしも XC や MS - C 6.0 {こ 
対する互換性が必要ならば， jtohira 関数を使用すること。 

規 格 —— Project LIBC Group ， MS - C 7.0 

関連項目—— - mbbtombc , mbctokata , mbctolower , mbctombb，mbctoupper 
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ライブラリー第 2 部 


mbctokata 


用 途——全角ひらがなを全角カタカナに変換する。 

書式-# include < mbstring . h > 

mt mbctokata (int c ); 

#include < jstring . h > 
int jtokata (int c ); 

解 説- mbctokata 関数は e で指定した全角ひらがなの文字コードを，全角カタカナの文 

字コードに変換する。 c が全角ひらがなでなかったり，変換できない場合はごを 
そのまま返す。 c は全角文字の第1バイトを上位8ビットに，第2バイトを下位 
8ビットに設定すること。 

戻り値—— c が変換可能ならばその変換結果を返し，不可ならば c をそのまま返す。 

注 意——通常， mbctokata 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定 
義されると実体をもつ関数となる。 mbctokata 関数がマクロとして展開される場 
合は，引数が副作用を伴わないように注意すること。 

mbctokata 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係 
がない。 


互換性—— jtokata 関数は mbctokata 関数に対する別名である。もしも XC や MS-C6.0 に 
対する互換性が必要ならば， jtokata 関数を使用すること。 

規 格 —— Project LIBC Group, MS-C7.0 

関埋項目 mbbtombc ， mbctohira ， mbctolower , mbctombb , mbctoupper 
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Chapter 4 — マルチバイト文字ライブラリ 


mbctolower 


用 途——全角英大文字を全角英小文字に変換する。 


書式- #mclude < mbstring . h > 

mt mbctolower、int c ); 

#include < jstring . h > 
int jtolower (int c ); 

解 説—— mbctolower 関数は c で指定した全角英大文字の文字コードを，全角英小文字の 

文字コードに変換する。 c が全角英大文字でなかったり，変換できない場合は c 
をそのまま返す。 C は全角文字の第 1 バイトを上位 8 ビットに，第 2 バイトを下 
位8ビットに設定すること。 

戻り値—— c が変換可能ならばその変換結果を返し，不可ならば c をそのまま返す。 


注 意——通常， mbctolower 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定 
義されると実体をもつ関数となる。 mbctolower 関数がマクロとして展開される 
場合は，引数が副作用を伴わないように注意すること。 

mbctolower 関数はシフト JIS コードを扱うためのものであり，ロケールとは関 
係がない。 



互換性—— jtolower 関数は mbct 010 wer 関数に対する別名である 0 もしも XC々MS-C6.0 
に対する互換性が必要ならば， jtolower •関数を使用すること。 


規 格 —— Project LIBC Group，MS-C7.0 


関連項目- mbbtombc , mbctohira , mbctokata , mbctombb , mbctoupper 
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ライブラリー第 2 部 


mbctombb 


用 途—全角文字を半角文字に変換する。 

書 式'- # include < mbstrmg . h > 

mt mbctombb ^mt c ); 

#include < jstring . h > 
int zentohan (int c ); 

解 説—— mbctombb 関数は c で 指定した シフト JIS 全角文字を，対応する半角文字に変換 

する。変換対象となるコードは，結果が 0 x 20 〜 0 x 7 E ， OxAl 〜 OxDF となるよう 
な コードのみで， それ以外の文字は変化しない。 

戻り値—— C が変換可能ならばその変換結果を返し，不可ならば C をそのまま返す。 

注 意—— mbctombb 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係 

がない。なお濁点や半濁点のついた文字は，これらを除いた文字に変換される。 

互換性—— zentohan 関数は mbctombb 関数に対する別名である。もしも XC や MS-C6.0 に 
対する互換性が必要ならば， zentohan 関数を使用すること。 

規 格- Project LIBC Group ， MS-C7.0 

関連項目- mbbtombc 


756 






Chapter 4 —マルチバイト文字ライブラリ 


mbctouoper 


用 途——全角英小文字を全角英大文字に変換する。 

書式- #include < mbstring . h > 

mt mbctoupper (mt c ); 

#include < jstring . h > 
int jtoupper (int c ); 

解 説- mbctoupper 関数は c で指定した全角英小文字の文字コードを，全角英大文字の 

文字コードに変換する。 C が全角英小文字でなかったり，変換できない場合は C * 
をそのまま返す。 c は全角文字の第1バイトを上位8ビットに，第2バイトを下 
位8ビットに設定すること。 

戻り値—— c が変換可能ならばその変換結果を返し，不可ならば c をそのまま返す。 

注 意——通常， mbctoupper 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定 
義されると実体をもつ関数となる。 mbctoupper 関数がマクロとして展開される 
場合は，引数が副作用を伴わないように注意すること。 

mbctoupper 関数はシフト JIS コードを扱うためのものであり，ロケールとは関 
係がない。 

互換性—— jtoupper 関数は mbctoupper 関数に対する別名である。もしも XC や MS-C6.0 
に対する互換性が必要ならば，： jtcmpper 関数を使用すること。 

規 格—— Project LIBC Group，MS-C7.0 

関連項目- mbbtombc , mbctohira , mbctokata , mbctolower , mbctombb 
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ライブラリ ー 第2部 


mbsbtype 


用 途—文字列中の指定位置の文字種を判別する。 

書式-# include < mbstring . h > 

int mbsbtype (const unsigned cnar * s , size_t n ); 

#include < jstring . h > 

int nthctype (const unsigned char * s , size_t n ); 

解 説—— mbsbtype 関数は s で指定した文字列の 《 バイト目の文字種を判別し，その結果を 

返す。ただし，《バイト目までに null 文字があった場合は MBC—ILLEGAL を返す。 


戻り値——で指定した文字列の《バイト目の文字種を返す。結果は次のマクロ値をとる。 


• MBC_SINGLE 

• MBC 丄 EAD 

• MBC.TRAIL 

• MBC.ILLEGAL 


半角文字 （0 x 20 〜 0 x 7 E，OxAl 〜 OxFC ) 
シフト JIS 全角文字の第1バイト 
シフト JIS 全角文字の第2バイト 
それ以外 （ null 文字を含む） 


注 意—— mbsbtype 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係 
がない。 


互換性—— nthctype 関数は mbsbtype 関数に対する別名である。もしも XC^MS-C6.(n: 
対する互換性が必要ならば， nthctype 関数を使用すること。 

規 格 —— Project LIBC Group, MS-C7.0 

関連項目- mbbtype 
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Chapter 4 —マルチバイト文字ライブラリ 


mbscat 


用 途——シフト JIS 文字列を他のシフト JIS 文字列に連結する。 


書 


- #include < mbstring . h > 

unsigned cnar *mbscat (unsigned char * mbstnngl , 

const unsigned char * mbstring 2); 


#include < jstring . h > 

unsigned char *jstrcat (unsigned char * mbstringl , 

const unsigned char * mbstring 2); 


解 説- mbscat 関数は/77わ打/7>^2の指す文字列を w か//の指す文字列の最後にコピー 

し，連結した文字列の最後に null 文字をつける。 m み打/の末尾の null 文字に 
は，の最初の文字を重ねてコピーする。 

文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも null 文字とみなす。 


戻り値- mbstringl へのポインタを返す。 

注 意 —— mbscat 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係が 

ない。また，1文字は1マルチバイト文字を意味する。 

mbstringm ， 連結した結果の文字列を格納するのに十分な領域を指していなけ 
ればならない。 



互換性一: jstrcat 関数は mbscat 関数に対する別名である。もしも 1(7 やに対 
する互換性が必要ならば j strcat 関数を使用すること 0 

規 格 —— Project LIBC Group , MS - C 7.0 

関連項目 一 -mbsncat 


759 







ライブラリー第 2 部 


mbschr 


用 途ーシフト JIS 文字列中から指定文字を検索する。 

書 式"- #include < mbstring . h > 

unsigned char *mbschr ^const unsigned char * mbstnng , 

int character ); 

#include < jstring . h > 

unsigned char *jstrchr (const unsigned char * mbstring , 

int character ); 

解 説一 mbschr 関数はが指す文字列中から，化 r で指定した文字を検索す 
る。爪&か/叹末尾の null 文字も検索の対象となり得る。 character に2バイ}'文 
字を指定するときは，1バイト目を上位8ビットに，2バイト目を下位8ビット 
に設定すること。 

文字列の最後は mill 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも null 文字とみなす。 

戻り値- mbstring 中 で最初に現れた character への ポインタを返す。見つからない場合は 

NULL を返す。 

注 意一 mbschr 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係が 

ない。また，1文字は1マルチバイト文字を意味する。 

互換性——: jstrchr 関数は mbschr 関数に対する別名である。もしも XC やに対 
する互換性が必要ならば ，： jstr chi * 関数を使用すること。 

規 格—— Project LIBC Group 、 MS - C 7.0 

関連項目- mbscsDn ， mbspbrk , mbsrchr , mbsspn , mbsstr , mbstok 
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Chapter 4 —マルチバイト文字ライブラリ 


mbscmp 


用 途一2つのシフト JIS 文字列を比較する。 

■rf 式- #mclude < mbstrmg . h > 

mt mbscmp ^const unsigned char * mbstnnerl , 
const unsigned char * mbstring 2); 

#include < jstring . h > 

int jstrcmp (const unsigned char * mbstringl , 
const unsigned char * mbstring 2); 

解 説- mbscmp 関数は， mbstringl の指す文字列との指す文字列とを上匕較する。 

比較は mill 文字が検出された時点で終了する。 

文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチ八イト文字が 
あった場合はそれも null 文字とみなす。 


戻り値——比較の結果，2つの文字列がまったく同じならば0を返す。異なる場合，その位 
置での側の文字が mbstringl 側の文字よりも大きければ正の値を，小 
さければ負の値を返す。 

注 意—— mbscmp 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係が 
ない。また，1文字は1マルチバイト文字を意味する。 

互換性—— jstrcmp 関数は mbscmp 関数に対する別名である。もしも ZC や佩 S -(76^ に対 
する互換性が必要ならば，： jstrcmp 関数を使用すること。 



規 格 —— Project LIBC Group , MS - C 7.0 


関連項目- mbsncmp 


761 







ライブラリー第 2 部 


mbscpy 


用 途ーシフト JIS 文字列をコピーする。 

式 - #include < mbstnng . h > 

unsigned char * mbscpy 、皿 signed char * mbstrine - l , 

const unsigned char * mbstring 2); 

#include < jstring . h > 

unsigned char *jstrcpy (unsigned char * mbstringl , 

const unsigned char * mbstring 2); 

解 説- mbscpy 関数はの指す文字列を， null 文字を含めて mbstringl の指す領 

域に コピーす る。 

文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも null 文字とみなす。 

戻り値- mbstringl へのポインタを返す。 

注 意—— mbscpy 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係が 

ない。また，1文字は1マルチバイト文字を意味する。 

領域が重なっていた場合，その動作は未定義である。また mbstringl ( i , mbstring2 
の指す文字列を格納するのに十分な領域を指していなければならない。 

互換性一 jstrcpy 関数は mbscpy 関数に対する別名である。もしも ZC や MS - に対 
する互換性が必要ならば， jstrcpy 関数を使用すること。 

規 格- Project LIBC Group , MS - C 7.0 

関連項目- mbsncpy 
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Chapter 4 ー マルチバイト文字ライブラリ 


mbscspn 


用 途——指定したシフト JIS 文字列に含まれない文字が，ほかのシフト JIS 文字列の先頭 

から何文字続いているかを調べる。 


書式- #mclude < mbstring . h > 

size_t mbscspn (const unsigned char * mbstringl , 
const unsigned char * mbstring 2); 
#include < jstring . h > 

size_t jstrcsDn (const unsigned char *mbstringl, 
const unsigned char *mbstring2); 


解 説- mbscspn 関数は爪6对/7>2ぎ/の指す文字列との指す文字列とを比較し， 

mbstringl の先頭から mbstring 2 に含まれない文字で構成されている部分の長さを 
調べる。 

文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも null 文字とみなす。 

戻り値- mbstringl の先風から ,に含まれない文字で構成されている部分の長さ 

を返す。 



注 意—— mbscspn 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係が 

ない。また，1文字は1マルチバイト文字を意味する。 


互換性—— jstrcspn 関数は mbscspn 関数に対する別名である。もしも XC や MS - C 6.0 に 
対する互換性が必要ならば ， j strcspn 関数を使用すること。 

規 格—— Project LIBC Group , MS - C 7.0 


関埋項目- mbschr , mbspbrk , mbsrchr , mbsspn , mbsstr , mbstok 
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ライブラリー第 2 部 


mbsdec 


用 途——シフト JIS 文字列のボインタを1文字分戻す。 

書 式 - #include < mbstring . h > 

unsigned char * mbsdec、const unsigned cnax * mDstrmg , 
unsigned char * ptr ); 

解 説' mbsdec 関数はが指す文字列のなかで，/?かが指す位置から1文字分戻っ 
た位置を求めて，その位置へのポインタを返す。 

文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも null 文字とみなす。 

戻り値——ぎが指定する文字列中で，/?ひが指定する位置から1文字戻った位置へのポ 
インタを返す。もし文字列の先頭で，これ以上戻れない場合は NULL を返す。 

注 意—— mbsdec 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係が 
ない。また，1文字は1マルチバイト文字を意味する。 

規 格一 Project LIBC Group ， MS - C 7.0 

関連項目- mbsinc , mbsnextc 


764 






Chapter 4 —マルチバイト文字ライブラリ 


mbsduD 


用 途——新しい領域を確保してシフト jis 文字列をコピーする。 


室 


式- #include く mbstring . h > 


unsigned char *mbsdup (const unsigned char * mbstrmg ); 


#include < jstring . h > 

unsigned char *jstrdup (const unsigned char * mbstring ); 


解 説—— mbsdup 関数は m か r / v>i 客の指す文字列を， null 文字を含めて malloc 関数によっ 
て確保した領域にコピーする。 

文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも null 文字とみなす。 


戻り値一正常にコピーできた場合はコピー先へのポインタを返し，失敗した場合は NULL 
を返して，変数 errno にその原因を示すエラーコードを設定する 0 

• EN 0 MEM メモリが足りなくなった 


注 意 —— mbsdup 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係が 
ない。また，1文字は1マルチバイト文字を意味する。 

互換性——: jstrdup 関数は mbsdup 関数に対する別名である。もしもに対 
する互換性が必要ならば， j strdup 関数を使用すること。 

規 格一 Project LIBC Group , MS - C 7.0 

関連項目- mbscpy 
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ライブラリ ー 第2部 


mbsicmp 


用 途——2つのシフト JIS 文字列を大文字/小文字を区別せずに比較する。 

書 式- #include < mbstring . h > 

int mbsicmp (.const unsigned char * mbstnngl , 
const unsigned char * mbstring 2); 

#include < jstring . h > 

int jstricmp (const unsigned char * mbstringl , 
const unsigned char * mbstring 2); 

解 説—— mbsicmp 関数はの指す文字列との指す文字列とを，大文字 
と小文字を区別しないで比較する。処理は null 文字が検出された時点で終了する。 

文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも null 文字とみなす。 

戻り値——比較の結果，2つの文字列がまったく同じならば0を返す。異なる場合，その位 
置での側の文字が w か rrz >^2 側の文字よりも大きければ正の値を，小 
さければ負の値を返す。 

注 意- mbsicmp 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係が 

ない。また，1文字は1マルチバイト文字を意味する。 

mbsicmp 関数は1バイト文字を大文字にしてから比較するが，2バイト文字に関 
しては大文字変換は行わない。 

互換性—— jstricmp 関数は mbsicmp 関数に対する別名である。もしも XC や MS - C 6.0 に 
対する互換性が必要ならば， jstricmp 関数を使用すること。 

規 格 —— Project LIBC Group , MS - C 7.0 

関連項目- mbscmp，mbsncmp 


766 






Chapter 4 —マルチバイト文字ライブラリ 


mbsinc 


用 途——シフト JIS 文字列のボインタを1文字分進める。 


書式- #include < mbstrmg . h > 

皿 signed char *mbsmc (const unsigned char * mbstring , 
unsigned chax * ptr ); 


解 説—— mbsinc 関数はが指す文字列のなかで， p かが指す位置から1文字分進ん 

だ位置を求めて，その位置へのポインタを返す。 

文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも null 文字とみなす。 

戻り値-ぎが指定する文字列中で，/?かが指定する位置から1文字進んだ位置への 

ボインタを返す。もし文字列の終端で，これ以上進めない場合は NULL を返す。 


注 意 一 mbsinc 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係が 

ない。また，1文字は1マルチバイト文字を意味する。 

規 格 —— Project LIBC Group ， MS - C 7.0 



関連項目- mbsdec , mbsnextc , mbsninc 
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ライブラリー第 2 部 


mbslen 


用 途——シフト JIS 文字列の長さを調べる。 

書式-# include < mbstring . h > 

size_t mbslen (const unsigned char * mbstrmg ); 

#include < jstring . h > 

size_t j strlen (const unsigned char * mbstring ); 

解 説—— mbslen 関数は，ひ/叩の指す文字列の末尾の null 文字を除いた文字列の長さ 
を調べる。 

文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも mill 文字とみなす。 

戻り値一末尾の null 文字を除いた文字列の長さを返す。 

注 意—— mbslen 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係が 
ない。また，1文字は1マルチバイト文字を意味する。 

互換性——: jstrlen 関数は mbslen 関数に対する別名である。もしも XC や MS - C 6.0 に対 
する互換性が必要ならば，： jstrlen 関数を使用すること。 

規 格—— Project LIBC Group 、 MS - C 7.0 

関連項目- mbscpy 
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Chapter 4 —マルチバイト文字ライブラリ 


mbslwr 


用 途ーシフト JIS 文字列を小文字に変換する。 

書式- #include < mbstring . h > 

皿 signed char *mbs 丄 wr (unsigned char * mbstnng ); 

#include < jstring . h > 

unsigned char *jstrlwr (unsigned char * mbstring ); 

解 説—— mbslwr 関数はぎが指す文字列を先頭から調べ，現在のロケールの LC.CTYPE 
カテゴリを基に大文字を小文字に変換する。処理は null 文字が検出された時点で 
終了する。 

文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも null 文字とみなす。 

戻り値- mbstring へのポインタを返す。 

注 意一 mbslwr 関数はシフト JIS コードを扱うためのものであり，2バイト文字に関して 
はロケールとは関係がない。また，1文字は1マルチバイト文字を意味する。 

mbslwr 関数が小文字に変換するのはシフト JIS 文字列中の1バイト文字だけで, 
2バイト文字に閨しては変換されない。 



互換性- jstrlwr 関数は mbslwr 関数に対する別名である。もしもやぢに対 

する互換性を必要とするならば，： jstrlwi •関数を使用すること 0 

規 格一 Project LIBC Group , MS - C 7.0 


関埋 ft 目- mbsnset , mbsrev , mbsset , mbsupr 
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ライブラリー第 2 部 


mbsnbcnt 


用 途——シフト JIS 文字列のバイト数を調べる。 

書式-# include < mbstring . h > 

size_t mbsnbcnt const unsigned char * mbstring , size_t n ); 

#include < jstring . h > 

size_t mtob (const unsigned char * mbstring , size_t n ); 

解 説—— mbsnbcnt 関数は wZ ? 打/ 7>2 g が指す文字列の先頭から，《文字が実際に何バイトあ 
るのかを求め，そのバイト数を返す。 

文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも null 文字とみなす。 

戻り値一が指定する文字列の A 2 文字目までのバイト数を返すが，《文字目に到達 
する前に null 文字があった場合はそこまでのバイト数となる。 

注 意—— mbsnbcnt 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係 
がない。また，1文字は1マルチバイト文字を意味する。 

互換性 —— mtob 関数は mbsnbcnt 関数に対する別名である。もしも XC や麗 S-C ぢに対す 
る互換性が必要ならば， mtob 関数を使用すること。 

規 格- Project LIBC Group ， MS—C 7. 0 

関連項目- mbsnccnt 
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Chapter 4 —マルチバイト文字ライブラリ 


mbsncat 


用 途——シフト JIS 文字列を指定文字数だけほかのシフト JIS 文字列に追加する。 


書 


式- #mclude < mbstrmg . h > 

unsigned char *mbsncat (unsigned char * mbstringl , 

const char * mbstring 2, size_t n ); 


#include <j string . ii > 

unsigned char *jstrncat (unsigned char * mbstringl , 

const char * mbstring 2, size_t n ); 


解 説- mbsncat 関数は mbstring 2 の指す文字列を mbstringl の指す文字列の最後にコピー 

し，連結した文字列の最後に null 文字をつける。⑺汾か/叹ゾの末尾の null 文字に 
は，ぎ2の最初の文字を重ねてコピーする。处理は null 文字が検出される 
か，《文字コピーした時点で終了する。 

文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも null 文字とみなす。 

戻り値- mbstringl へのポインタを返す。 

注 意一 mbsncat 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係が 

ない。また，1文字は1マルチバイト文字を意味する。 

mbstringl は ，連結した結果の文字列を格納するのに十分な領域を指していなけ 
ればならない。 



互換性- jstrncat 関数は mbsncat 関数に対する別名である。もしも XC や MS-C 6.0 に 

対する互換性が必要ならば， jstrncat 関数を使用すること。 

規 格 —— Project LIBC Group ， MS - C 7.0 

関連項目- mbs cat 
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ライブラリー第 2 部 


mbsnccnt 


用 途——シフト JIS 文字列の文字数を調べる。 

書 式- # include く mbstring . li > 

size_t mbsnccnt (const unsigned char * mbstring , size_t n ); 

#include < jstring . h > 

size_t btom (const unsigned char * mbstring , size_t n ); 

解 説一 mbsnccnt 関数は mZwrn •叩が指す文字列の先頭から，《バイトが実際に何文字に 

なるか求め，その文字数を返す。 

文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも null 文字とみなす。 

戻り値——か/叩が指定する文字列の/?バイト目までの文字数を返すが，《バイト目に到 
達する前に null 文字があった場合は，そこまでの文字数となる。 

注 意—— mbsnccnt 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係 

がない。また，1文字は1マルチバイト文字を意味する。 


互換性—— btom 関数は mbsnccnt 関数に対する別名である。もしもやに対す 
る互換性が必要ならば， btom 関数を使用すること。 

規 格 —— Project LIBC Group ， MS - C 7.0 

関連項目-- mbsnbcnt 


772 






Chapter 4 —マルチバイト文字ライブラリ 


mbsncmp 


用 途——2つのシフト JIS 文字列を指定文字数だけ比較する。 • 

書式- #include <mbstr ing . n > 

int mbsncmp (const unsigned char * mbstringl , 

const unsigned char * mbstring 2, size_t n ); 

#include < jstring . h > 

int jstrncmp (const unsigned char * mbstringl , 

const unsigned char * mbstring 2, size_t n ); 

解 説- mbsncmp 関数は， mZw び/の指す文字列とび// 2 がの指す文字列とを比較す 

る。処理は null 文字が検出されるか，《文字比較した時点で終了する。 

文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも mill 文字とみなす。 


戻り値——比較の結果，2つの文字列がまったく同じならば0を返す。異なっていたり/2文 
字を比較し終えた場合，その位置での打/•/呢ゾ側の文字が爪ゐ对/7>2^2側の文字 
よりも大きければ正の値を，小さければ負の値を返す。 

注 意—— mbsncmp 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係が 

ない。また，1文字は1マルチバイト文字を意味する。 



互換性 —— j strncmp 関数は mbsncmp 関数に対する別名である。もしもや MS - C 6.0 に 
対する互換性が必要ならば， mbsncmp 関数を使用すること。 

規 格 —— Project LIBC Group ， MS - C 7.0 

関連項目- mbscmp 
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ライブラリー第 2 部 


mbsncpv 


用 途ーシフト JIS 文字列を指定文字数だけコピーする。 

書 式- #include < mbstring . h > 

unsigned char *mbsncpy (unsigned char * mDstnngl , 

const unsigned char * mbstring 2, 
size_t n ); 

#include < jstring . h > 

unsigned char *jstrncpy (unsigned char * mbstringl , 

const 皿 signed char * mbstring 2, 
size.t n ); 

解 説- mbsncpy 関数は mbstring 2 の指す文字列の最初の《文字までを， mbstringl の指 

す領域にコピーする。処理は null 文字が検出されるか， n 文字コピーした時点で 
終了する。 

文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも null 文字とみなす。 

戻り値- mbstringJ へのポインタを返す。 

注 意—— mbsncpy 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係が 
ない。また，1文字は1マルチバイト文字を意味する。 

領域が重なっていた場合，その動作は未定義である。また， mbstringl は n 文字 
を格納するのに十分な領域を指していなければならない。 

互換性一 jstrncpy 関数は mbsncpy 関数に対する別名である。もしも XC や MS - C 6.0 に 
対する互換性が必要ならば， jstrncpy 関数を使用すること。 

規 格一 Project LIBC Group ， MS - C 7.0 

関連項目- mbscpy 
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Chapter 4 ーマルチバイト文字ライブラリ 


mbsnextc 


用 途——ボインタが指す位置文字を返す。 

書式- #include < mbstring . n > 

int mbsnextc (const unsigned chax * ptr ); 

解 説—— mbsnextc 関数は 〆 /•が指す位置から 1 マルチバイト文字を取り出し，その値を 

返す。 

文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも null 文字とみなす。 

戻り値——が r が指定する位置の1マルチバイト文字を返すが，この文字が2八イト文字だっ 
た場合は1バイト目を上位8ビットに，2バイト目を下位8ビットに格納する。 

注 意一 mbsnextc 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係 
がない。また，1文字は1マルチバイト文字を意味する。 

規 格 —— Project LIBC Group , MS - C 7.0 

関連項目- mbsdec , mbsinc , mbsninc 
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ライブラリー第 2 部 


mbsmnc 


用 途——シフト JIS 文字列のボインタを指定文字分だけ進める。 

書式-# include < mbstring . h > 

unsigned char *mbsninc kconst unsigned char * mbstnng , 

size.t n ); 

#include く ; j string 上> 

unsigned chax *jstradv (const unsigned char * mbstring , 

size_t n ); 

解 説一 mbsninc 関数は び//^ が指す文字列の A 2 文字目の位置を求めて，その位置への 
ポインタを返す。 

文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも null 文字とみなす。 

戻り値—— 爪 & か//^ が指定する文字列の 《 文字目の位置を求め，その位置へのポインタを返 
す。もし文字列の終端で，これ以上進めない場合は NULL を返す。 

注 意 - mbsninc 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係が 

ない。また，1文字は1マルチバイト文字を意味する。 

互換性—— jstradv 関数は mbsninc 関数に対する別名である。もしも ZC や MS-C 戌に対 
する互換性が必要ならば， jstradv 関数を使用すること。 

規 格一 Project LIBC Group ， MS - C 7.0 


関連項目- mbsinc , mbsnextc 
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Chapter 4 — マルチバイト文字ライブラリ 


mbsnset 


用 途——シフト JIS 文字列を指定文字で指定文字数だけ埋める。 


書 


式- #include < mbstnng . h > 

unsigned char *mbsnset (皿 signed char * mbstrmg , 

int character , size_t n ); 


#include < jstring . h > 

unsigned chax *jstrnset (unsigned char * mbstring , 

int character , size_t n ); 


解 説* ^ mbsnset 関数は爪汾かかぎが指す文字列の先頭から， n 文字か null 文字を検出す 

るまで， ckmc 妙で指定した文字で埋める。 character に 2バイト文字を指定す 
るときは，1バイト目を上位8ビットに，2バイト目を下位8ビットに設定する 
こと。 

もしも character に2バイ ト文字を設定した場合，文字列領域が奇数バイトなら 
ば最後の1バイトは1バイトスペースで埋められる。 

文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも null 文字とみなす。 


戻り値 •へのポインタを返す0 


注 意一 mbsnset 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係が 

ない。また，1文字は1マルチバイト文字を意味する。 

«は文字列領域の大きさを越えてはならない。 



互換性—— jstrnset 関数は mbsnset 関数に対する別名である。もしも XC や MS - C 6.0 に 
対する互換性が必要ならば， jstrnset 関数を使用すること 0 


規 格 —— Project LIBC Group ， MS - C 7.0 


関連項日 - mbslen , mbslwr , mbsrev ， mbsset , mbsupr 
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ライブラリー第 2 部 


mbspbrk 


用 途——指定したシフト JIS 文字列に含まれる文字が，ほかのシフト JIS 文字列に存在す 
るかどうかを調べる。 


書 


式-— #include < mbstnng . h > 

unsigned char *mbspbrk ^const unsigned cnar * mbstringl , 

const unsigned char * mbstring 2); 


#include < jstring . h > 

unsigned char *jstrpbrk (const unsigned char * mbstringl , 

const 皿 signed char * mbstring 2); 


解 説—— mbspbrk 関数はの指す文字列と m 加び//の指す文字列とを比較し， 
mbstring 2 に含まれる文字が最初に現れる場所を検索する。 

文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも null 文字とみなす。 


戻り値- mbstringl 中で， wto /7>2 が2に含まれる文字が最初に現れる位置へのポインタを返 

す。見つからない場合は NULL を返す。 


注 意 ——mbspbrk 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係が 
ない。また，1文字は1マルチバイト文字を意味する。 


互換性—— jstrpbrk 関数は mbspbrk 関数に対する別名である。もしも ZC や MS - に 
対する互換性が必要ならば， jstrpbrk 関数を使用すること。 

規 格 —— Project LIBC Group , MS - C 7.0 

関連項目- mbschr , mbscspn , mbsrchr , mbsspn , mbsstr , mbstok 
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Chapter 4 —マルチバイト文字ライブラリ 


mbsrcnr 


用 途——シフト JIS 文字列中から指定文字が最後に現れる位置を検索する。 


書 


式-: frinc 丄 ude < mbstrmg . h > 

皿 signed char *mbsrchr (const unsigned char * mbstring , 

int character ); 


#include < jstring . h > 

unsigned char *jstrrchr (const unsigned char * mbstring , 

int character ); 


解 説—— mbsrchr 関数はが指す文字列中から，で指定された文字が最 

後に現れる位置を検索する。爪&ぴかざ末尾の null 文字も検索の対象となり得る。 
character に2バイ ト文字を指定するときは，1バイト目を上位8ビットに，2バ 
イト目を下位8ビットに設定すること。 

文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも mill 文字とみなす。 

戻り値——び/叩中でが最後に現れる位置へのポインタを返す。見つからない 
場合は NULL を返す。 



注 意—— mbsrchr 関数はシフト JIS コードを扱うためのものであり，ロケールとは閨係が 

ない。また，1文字は1マルチバイト文字を意味する。 


互換性- jstrrchr 関数は mbsrchr 関数に対する別名である。もしも XC や MS - C6.0 に 

対する互換性が必要ならば， jstrrchr 関数を使用すること。 


規 格 —— Project LIBC Group、MS-C7.0 


関連項目- mbschr , mbscspn , mbspbrk , mbsspn , mbsstr , mbstok 
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ライブラリー第 2 部 


mbsrev 


用 途——シフト JIS 文字列を前後反転させる。 

書 式 -# include <mbstring.h> 

unsigned char *mbsrev ^unsigned char *mbstnng); 

#include く jstring.h> 

unsigned char *jstrrev (unsigned char *mbstring); 

解 説 一 mbsrev 関数は mtorfwg が指す文字列を前後反転させる 0 

文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも null 文字とみなす。 

戻り値 — ぎへの ポインタを返す0 

注 意—— mbsrev 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係が 
ない。また，1文字は1マルチバイト文字を意味する。 

互換性 —— jstrxev 関数は mbsrev 関数に対する別名である。もしも XC ゃ MS-C6.0 に M 
する互換性が必要ならば，」 strrev 関数を使用すること 0 

規 格 —— Project LIBC Group ， MS-C7.0 

関連項目 - mbslwr, mbsnset, mbsset, mbsupr 
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Chapter 4 —マルチバイト文字ライブラリ 


mbsset 


用 途——シフト JIS 文字列を指定文字で埋める。 


書 


式- #mclude < mbstnng . h > 

unsigned char *mbsset (unsigned char * mbstring , 

int character ); 


#include < jstring . h > 

unsigned char *jstrset (unsigned char * mbstring , 

int character ); 


解 説- mbsset 関数はが指す文字列の先頭から， null 文字に出会う まで character 

で指定した文字で埋める。 character に2バイ ト文字を指定するときは，1バイト 
目を上位8ビットに，2バイト目を下位8ビットに設定すること。 

もしも character [こ2バペ ト文字を設定した場合，文字列領域が奇数バイトなら 
ば，最後の1バイトは1バイトス ペースで 埋められる。 


文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも null 文字とみなす。 


戻り値-へのポインタを返す。 


注 意—— mbsset 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係が 

ない。また，1文字は1マルチバイト文字を意味する。 

互換性—— jstrset 閨数は mbsset 関数に対する別名である。もしも ZC やに対 
する互換性が必要ならば，： jstrset 関数を使用すること。 


規 格- Project LIBC Group ， MS-C 7.0 


関埋項目- mbslwr , mbsnset , mbsrev , mbsupr 
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ライブラリー第 2 部 


mbsspn 


用 途一指定したシフト JIS 文字列に含まれる文字が，ほかのシフト JIS 文字列の先頭か 

ら何文字続いているかを調べる。 

書 式- #include < mbstring . h > 

size_t mbsspn ^const unsigned char * mbstringi , 
const unsigned char * mbstring 2); 

#include < jstring . H > 

size_t j strspn (const unsigned char * mbstringl , 
const unsigned char * mbstring 2); 

解 説- mbsspn 関数は mbstringl の指す文字列と mbstring 2 の指す文字列とを比較し， 

mbstringl の 先頭から mbstringl に含まれる文字で構成されている部分の長さを調 
ベる0 

文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも null 文字とみなす。 

戻り値- mbstringl の失 M から， 爪ゐ打/7>7ル2に含まれる文字で構成されている部分の長さを 

返す。 

注 意—— mbsspn 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係が 

ない。また，1文字は1マルチバイト文字を意味する。 


互換性 —— j strspn 関数は mbsspn 関数に対する別名である。もしも XC や に対 
する互換性が必要ならば ， j strspn 関数を使用すること。 

規 格 —— Project LIBC Group , MS - C 7.0 

関連項目- mbschr , mbscspn , mbspbrk , mbsrchr , mbsstr , mbstok 
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Chapter 4 —マルチバイト文字ライブラリ 


mbsstr 


用 途一指定したシフト JIS 文字列がほかのシフト JIS 文字列に存在するかどうかを調 

ベる0 

書式- #include < mbstnng . li > 

size_t mbsstr (const unsigned char * mbstnngi , 
const unsigned char * mbstring 2); 

#include < jstring . n > 

size_t jstrstr (const unsigned char * mbstringl , 
const unsigned char * mbstring 2); 

解 説—— mbsstr 関数はの指す文字列との指す文字列とを比較し， 

mbstringl のなかで， 文字列が最初に現れる位置を検索する。 

文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも null 文字とみなす。 

戻り値- mbstringl 中で, mbstring 2 が最初に現れる位置へのポインタを返す 0 

注 意—— mbssti •問数はシフト JIS コードを扱うためのものであり，ロケールとは関係が 

ない。また，1文字は1マルチバイト文字を意味する。 



互換性一 jstrstr 関数は mbsstr 関数に対する別名である。もしも XC •やに対 
する互換性が必要ならば，：) strstr 関数を使用すること。 

規 格- Project LIBC Group , MS-C 7. 0 

関埋項目- mbschr ， mbscspn , mbspbrk , mbsrchr , mbsspn，mbstok 
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ライブラリー第 2 部 


mbstok 


用 途ーシフト JIS 文字列を指定した区切り文字でトークンに分ける。 

書 式- # include < mbstring . h > 

unsigned char *mbstok (unsigned char * mbstring , 

const unsigned char * delim ); 

#include < jstring . h > 

unsigned char *jstrtok (unsigned char * mbstring , 

const unsigned char * delim ); 

解 説 —— mbstok 関数を連続して呼ぶことによって，か/が指す文字列を語句 （ トーク 

ン）に分解することができる。各語句は，み/が指す文字列に含むまれる区切り 
文字（デリミタ）によって区切られる。 

最初に mbstok 関数を呼び出すときは，デリミタ文字列を爪加ぴ/呢に指定し，以 
降 mbstok 関数を呼び出すときには，爪ゐ於/*/叹に NULL を指定する。デリミタ文字 
列は， mbstok 関数を呼び出すたびに変更することができる。 mbstring にデ')ミ 
夕文字列が続く場合は無視される。 

文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも null 文字とみなす。 

戻り値 —— 語句が見つかれば最後の区切り記号の位置に null 文字を設定し，語句の最初の文 
字へのポインタを返す。見つからなければ NULL を返す。 

注 意 —— mbstok 関数はシフト JIS コードを扱うためのものであり，ロケールとは関係が 
ない。また，1文字は1マルチバイト文字を意味する。 

mbstok 関数は与えられた⑺&か加ぎの領域を書き換えるので，元のデータが必要 
な場合は自分で保存する必要がある。 

互換性 一 : jstrtok 関数は mbstok 関数に対する別名である。もしも ZC 7 や MS - (76^ に対 
する互換性が必要ならば， jstrtok 関数を使用すること。 

規 格—— Project LIBC Group ， MS - C 7.0 

関連項目- mbschr , mbscspn , mbspbrk , mbsrchr ， mbsspn , mbsstr 
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Chapter 4 —マルチパイト文字ライブラリ 


mbsupr 


用 途—シフト JIS 文字列を大文字に変換する。 

■rf 式- #mclude < mbstrmg . n > 

unsigned char *mbsupr (unsigned char * mbstring ); 

#include < jstring . h > 

unsigned char *jstrupr (unsigned char * mbstring ); 

解 説—— mbsupr 関数はが指す文字列を先頭から調べ，現在のロケールの LC.CTYPE 

カテゴリを基に小文字を大文字に変換する。処理は null 文字を検出した時点で終 
了する。 

文字列の最後は null 文字で判別されるが，不正なシフト JIS マルチバイト文字が 
あった場合はそれも null 文字とみなす。 

戻り値-へのポインタを返す。 


注 意—— mbsupr 関数はシフト JIS コードを扱うためのものであり，2バイト文字に関して 

はロケールとは関係がない。また，1文字は1マルチバイト文字を意味する。 

mbsupr 関数が大文字に変換するのはシフト JIS 文字列中の1バイト文字だけで, 
2バイト文字に関しては変換されない。 



互換性- j strupr 関数は mbsupr 関数に対する別名である。もしも XC や MS - C 6.0 に対 

する互換性が必要ならば， j strupr 関数を使用すること。 

規 格一 Project LIBC Group ， MS - C 7.0 

関埋項目- mbslwr ， mbsnset , mbsrev，mbsset 
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Chapter 5 


SCSI コールライブラリ 


本章には Human 68 k の SCSI コール ライブラリの マニュアルを 掲載し 
ます。では従来のとの互換性を考慮し，名前が異なる以外，基 
本的な動作はすべて同じになるように作成してあります。 

本書では関数ごとの マニュアルに とどめ ， SCSI コール および SCSI 自 
体についての詳しい説明は特にしていません。これらについてより詳し 
く知りたい場合は，他の書籍などを参照してください。 


























































































































































































































ライブラリー第 2 部 


scsicmaout 


用 途— コマン ド アウトフヱー ズを実行する。 

書 式- #include < sys/scsi . h > 

int _ scsi_cmdout (mt n , const void . * cdb ); 

解 説—— _ scsi _ cmdout 関数は， c ぬが指す領域から《バイトをコマンドとして SCSI バ 

ス上に出力し，コマンドアウトフェーズを実行する。 

戻り値——正常終了した場合は0を返し，失敗した場合はその原因を示す SCSI エラーコー 
ドを返す。 

注 意—— . scsi _ cmdout 関数は SCSI デバイスドライバを登録することにより，初めて使用 
することができる。登録されていない場合，その動作は一切保証されないので注 
意すること。 

規 格- Project LIBC Group , XC 

関埋項目- - scsi _ select ，_ scsi_testunit 
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Chapter 5 — SCSI コーノレライブラリ 


datain 


用 途ー データ イン フヱーズを 実行す る。 

書 式- #include < sys/scsi . h > 

int _ scsi_datain (int n , void * buff ); 

解 説一 _ sc S i _ dataiii 関数はデータインフェーズを実行して， SCSI バス上から DMA 転 

送を用いて/2バイトのデータを読み込み，が指す領域に格納する。 

戻り値——正常終了した場合は0を返し，失敗した場合はその原因を示す SCSI エラーコー 
ドを返す。 

注 意一 _ s C si _ dataiii 関数は SCSI デバイスドライバを登録することにより，初めて使用 

することができる。登録されていない場合，その動作は一切保証されないので注 
意すること。 

buffit , 最低でも以上の大きさの領域を指していなければならない。 

規 格- Project LIBC Group , XC 

関連項目- _ scsi _ datain _ p , _ scsi _ dataout , _ scsi _ datao \ rt _ p ， _ scsi _ select , 

_ scsi_testunit 
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ライブラリー第 2 部 


scsidatam 


用 途— データ イン フヱーズを 実行す る。 

書 式- # include < sys / scsi . h > 

int _ scsi _ datain_p unt n , void . * buff ); 

解 説—— _ scsi _ datain _ p 関数はデータインフェーズを実行して， SCSI バス上からプログ 
ラム転送を用いて《バイトのデータを読み込み，が指す領域に格納する。 

戻り値——正常終了した場合は〇を返し，失敗した場合はその原因を示す SCSI エラーコー 
ドを返す。 

注 意—— _ SCS i _ dataiix _ p 関数は SCSI デバイスドライバを登録することにより，初めて使 

用することができる。登録されていない場合，その動作は一切保証されないので 
注意すること。 

buffkt 、 最低でも A 2 以上の大きさの領域を指していなければならない。 

規 格- Project LIBC Group 


関連項目- _ scsi _ datain , _ scsi _ dataout , 

_ scsi_testunit 


_s c s 1 _dat aout _ p ? _ scsi _ seiec * c , 
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Chapter 5 — SCSI コールライブラリ 


scsi daiaoui 


用 途—— データ アウトフ ヱーズを 実行する。 

書 式- #include < svs / scsi . h > 

int _ scsi_dataout (int n , const void * bufi ;; 



解 説- _ scsi _ dataout 関数はデータアウトフェーズを実行して， DMA 転送を用いて ， buff 

が指す領域から《バイトを SCSI バス上に書き込む。 

戻り値一正常終了した場合は〇を返し，失敗した場合はその原因を示す SCSI エラーコー 
ドを返す。 

注 意一 _ scsi _ dataout 関数は SCSI デバイスドライバを登録することにより，初めて使 

用することができる。登録されていない場合，その動作は一切保証されないので 
注意すること。 


規 格- Project LIBC Group , XC 

関連項目- _ scsi _ datain , _ scsi _ datain _ p , _ scsi _ dataout _ p , _ scsi _ select ， 

_ scsi_testunit 
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ライブラリー第 2 部 


scsidataout— 


用 途ーデータアウトフェーズを実行する。 

書 式^-# include <sys/scsi.h> 

int _scsi_dataout_p (int n, const void *buff); 

解 説- _scsi_dataout_p 関数はデータアウトフェーズを実行して，プログラム転送を用 

いて，如#が指す領域から《バイトを SCSI バス上に書き込む。 

戻り値——正常終了した場合は 0 を返し，失敗した場合はその原因を示す SCSI エラーコー 
ドを返す。 

注 意—— _ S csi_datacmt_p 関数は SCSI デバイスドライバを登録することにより，初めて 

使用することができる。登録されていない場合，その動作は一切保証されないの 
で注意すること。 

規 格- Project LIBC Group 

関埋 I 貝目 - _scsi_datain, _scsi_datain_p, _scsi_aataout, _scsi_select, 

_scsi_testunit 
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Chapter 5— SCSI コーノレライブラリ 


scsi format 


用 途- SCSI ユニットを物理フォーマットする。 


エぐ- frincmde < sys / scsi . h > 

mt _ scsi_format ^mt shift , mt id ); 


解 説- _ scsi _ format 関数は / ゴで指定した SCSI ID の SCSI ユニットを， • s / zzy ? で指定し 

たインタリーブ値で物理フォーマツトする。 



戻り値——正常終了した場合はステータス情報を返し，失敗した場合は負の値を返す。ス 
テータス情報は上位がメッセージインフェーズで得た情報，下位がステータスイ 
ンフ I ーズで得た情報である。 


注 意一 _ scsi _ format 関数は SCSI デバイスドライバを登録することにより，初めて使用 

することができる。登録されていない場合，その動作は一切保証されないので注 
意すること。 


規 格 —— Project LIBC Group , XC 


関連項目- _ scsi _ select , _ scsi_testunit 
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ライブラリー第 2 部 


_scsi 」 riau_ry 


用 途—— INQUIRY データを要求する。 

書 式- # include < sys / scsi . h > 

int _ scsi_inquirv (int n , int id , struct .inquiry 本 buff ); 

解 説—— _ scsi _ inquiry 関数は / ゴで指定した SCSI - ID ユニットから， INQUIRY データを 
/2バイト読み込んで，ガが指す領域に格納する。 

戻り値——正常終了した場合はステータス情報を返し，失敗した場合は負の値を返す。ス 
テータス情報は上位がメッセージインフエーズで得た情報，下位がステータスイ 
ンフ I ーズで得た情報である。 

注 意—— _ scsi _ inquiry 関数は SCSI デバイスドライバを登録することにより，初めて使 
用することができる。登録されていない場合，その動作は一切保証されないので 
注意すること。 

最低でも《以上の大きさの領域を指していなければならない。 

規 格一 Project LIBC Group , XC 

関埋項目一 —_ scsi _ select , _ scsi_testunit 
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Chapter 5— SCSI コールライブラリ 


scsi modeselect 


用 途- SCSI ュニッ トにモードセレクト コマンド を発行する。 

谱式- #mclude < sys / scsi . h > 

mt _ scsi_modeselect (int mode , mt 丄 en , 

int id , const void * buff ); 

解 説- _ scsi _ modeselect 閉数は，如ガが指す領域から kn バイト をパラメータとし 

て SCSI-ID ユニットに書き込む。 また mode には， PF (ページフォーマット）, 
SP (セーブパラメータ）のビットを指定する。 

戻り値一正常終了した場合はステータス情報を返し，失敗した場合は負の値を返す。ス 
テータス情報は上位がメッセージインフ I ーズで得た情報，下位がステータスイ 
ンフヱーズで得た情報である。 


注 意一 _ scsijnodeselect 関数は SCSI デバイスドライバを登録することにより，初めて 

使用することができる。登録されていない場合，その動作は一切保証されないの 
で注意すること。 

規 格 —— Project LIBC Group , XC 



関連項巨- - scsi — select ，_ scsi_testunit 
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ライブラリー第 2 部 


modesense 


用 途 —— SCSI ュニッ トの各種パラメータを調べる。 

書 式- #include < sys / scsi . h > 

int _ scsi_modesense unt page , 

int n , int id , void * buff ); 

解 説- _ scsi_mode sense 関数は供 ( PCF / ページコード）を指定して，/ゴで指定した 

SCSI ID の SCSI ユニッ トのパラメータを 《( アロケーシヨンレングス）バイト読 
み込み，が指す領域に格納する。 

戻り値——正常終了した場合はステータス情報を返し，失敗した場合は負の値を返す。ス 
テータス情報は上位がメッセージインフエーズで得た情報，下位がステータスイ 
ンフエーズで得た情報である。 

注 意- _ scsi _ modesense 関数は SCSI デバイスドライバを登録することにより，初めて 

使用することができる。登録されていない場合，その動作は一切保証されないの 
で注意すること。 

buff は， 最低でも以上の大きさの領域を指していなければならない。 

規 格- Project LIBC Group , XC 

関連項目- _ scsi _ select , _ scsi_testunit 
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Chapter 5— SCSI コールライブラリ 


—scsi— 


用 途—メッセージインフヱーズを実行する。 

書式- #include < svs / scsi . h > 

int _ scsi_msgin 、void * buff ); 

解 説- _ scsi _ msgin 関数はメッセージインフェーズを実行して，ゐが指す領域に1バ 

イトのデータを SCSI バス上から読み込む。 

戻り値——正常終了した場合は0を返し，失敗した場合はその原因を示す SCSI エラーコー 
ドを返す。 

注 意一 _ scsi _ msgin 関数は SCSI デバイスドライパを登録することにより，初めて使用 
することができる。登録されていない場合，その動作は一切保証されないので注 
意すること。 

buff は， 最低でも1バイト以上の大きさの領域を指していなければならない。 

規 格 —— Project LIBC Group , XC 
関連項目- _ scsi - select ，_ scsi_testunit 
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ライブラリー第 2 部 


msaout 


用 途——メッセージアウトフヱーズを実行する。 

書式- #include < sys / scsi . h > 

int _ scsi_msgout (const void * bufi ;; 

解 説- _ scsi_msgout 関数はメッセージアウトフェーズを実行して，ゐ w ガが指す領域から 

1バイトのデータを SCSI バス上に書き込む。 

戻り値——正常終了した場合は0を返し，失敗した場合はその原因を示す SCSI エラーコー 
ドを返す。 

注 意—— _ scsi_msgout 関数は SCSI デバイスドライバを登録することにより，初めて使用 
することができる。登録されていない場合，その動作は一切保証されないので注 
意すること。 

規 格 —— Project LIBC Group , XC 

関埋項目- _ scsi _ select , _ scsi_testunit 
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Chapter 5— SCSI コールライブラリ 


pamedium 


用 途—— SCSI ュニットにメディアのイジヱクトの禁止/許可を設定する。 

式- frinc 丄 ude < sys / scsi . h > 

mt _ scsi_pamedium (int mode , int id ); 

解 説—— - scsi _ pamedium 関数は/ゴで指定した SCSI ID の SCSI ユニットに，イジヱクト 

のモードを設定する。 W 0 みが0ならばイジヱクト許可，1ならばイジヱクト禁止 
となる。 

戻り値一正常終了した場合はステータス情報を返し，失敗した場合は負の値を返す。ス 
テータス情報は上位がメッセージインフ x —ズで得た情報，下位がステータスイ 
ンフヱーズで得た情報である。 

注 意—— - scsi — pamedium 関数は SCSI デバイスドライバを登録することにより，初めて使 
用することができる。登録されていない場合，その動作は一切保証されないので 
注意すること。 

規 格一 Project LIBC Group , XC 

関連項目- _ scsi _ select ，_ scsi_testunit 
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ライブラリー第 2 部 


scsi—phase 


用 途一 SCSI フヱーズセンスを実行する。 

書式- frmc 丄 ude < sys / scsi . h > 

int _ scsi . pliase 、 void ); 

解 説- _ scsi _ phase 関数は，現在実行しているフヱーズを SPC ( SCSI プロトコルコン 

ト ローラ） の PSNS レジスタから読み出す。 

戻り値—— PSNS レジスタの内容を返す。 

注 意一 _ scsi _ plia Se 関数は SCSI デバイスドライバを登録することにより，初めて使用 
することができる。登録されていない場合，その動作は一切保証されないので注 
意すること。 

規 格- Project LIBC Group , XC 

関埋項目- _ scsi _ select , _ scsi_testunit 
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Chapter 5— SCSI コーノレライブラリ 


read 


用 途- SCSI ュニッ トのデータを読み込む。 

-b xt - #include < svs/scsi . h > 

mt _ scsi_read (int pos , int blk , 

int id , int size , void * buff ); 

解 説—— _ scsi _ read 関数は / ゴで指定した SCSI ID の SCSI ユニットの pay (論理ブロック 
番号）の位置から，6/ん(論理ブロック数） x * s 知(0=256，1=512， 2=1024) バイト 
を読み込み，が指す領域に格納する。 

戻り値——正常終了した場合はステータス情報を返し，失敗した場合は負の値を返す。ス 
テータス情報は上位がメッセージ インフ I ー ズで得た情報，下位が ステータスイ 
ンフヱ ーズで得た情報である。 

注 意—— — scsiiead 関数は SCSI デバイスドライバを登録することにより，初めて使用す 

ることができる。登録されていない場合，その動作は一切保証されないので注意 
すること。 

buff は， 結果を格納するだけの十分な大きさの領域を指していなければならない。 

規 格 —— Project LIBC Group , XC 

関連項目- _ scsi _ select , _ scsi_testunit 
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ライブラリー第 2 部 


一 readcap 


用 途- SCSI ュニットの容量に関する情報を読み込む。 

書式- #mclude < sys / scsi . h > 

mt _ scsi_readcap (mt ia , 一 readcap ; 

解 説—— _ scsi _ readcap 関数は/ゴで指定した SCSI ID の SCSI ユニットの READ CAPACITY 
データを8バイト分，が指す領域に読み込む。 

戻り値——正常終了した場合はステータス情報を返し，失敗した場合は負の値を返す。ス 
テータス情報は上位がメッセージインフヱーズで得た情報，下位がステータスイ 
ンフヱーズで得た情報である。 

注 意—— — scsi - readcap 関数は SCSI デバイスドライバを登録することにより，初めて使 
用することができる。登録されていない場合，その動作は一切保証されないので 
注意すること。 

buff は、 最低でも8バイト以上の大きさの領域を指していなければならない。 

規 格 —— Project LIBC Group , XC 
関埋項目- _ scsi - select ，_ scsi_testunit 
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Chapter 5— SCSI コールライブラリ 


_scsi—readext 


用 途-披張 READ コマン ドで SCSI ュニッ トのデータを読み込む。 

# 式- frinc 丄 ude < sys / scsi . h > 

int _ scsi_readext (mt pos , int blk , 

int id , int size , void * buff ); 

解 説—— - scsijreadext 関数は W で指定した SCSI ID の SCSI ユニットの pay (論理ブロッ 
ク番号）の位置から， M : (論理ブロック数） xj 加 (0=256, 1=512, 2=1024) バイ 
卜を読み込み，ガが指す領域に格納する。論理ブロック数は65535ブロックま 
で指定可能。 

戻り値一正常終了した場合はステータス情報を返し，失敗した場合は負の値を返す。ス 
テータス情報は上位がメッセージインフ I ーズで得た情報，下位がステータスイ 
ンフェーズで得た情報である。 

注 意—— _ scsi _ readext 関数は SCSI デバイスドライバを登録することにより，初めて使 

用することができる。登録されていない場合，その動作は一切保証されないので 
注意すること。 

buff は， 結果を格納するだけの十分な大きさの領域を指していなければならない。 

規 格 —— Project LIBC Group , XC 

関連項目- _ scsi _ se 丄 ect , _ scsi_testunit 
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ライブラリー第 2 部 


scsi .reassign 


用 途—— SCSI ュニットの欠陥ブロックの再割り当てを行う。 

僅 瓦- # include < sys / scsi . h > 

int _ scsi_reassign unt n , int id , const void * bufi ;; 

解 説—— _ scsi _ reassign 関数は如ガが指す領域から《バイトを ， REASSIGN BLOCKS コマ 
ンドにより，/ゴで指定した SCSI ID の SCSI ユニットに書き込む。 

戻り値——正常終了した場合はステータス情報を返し，失敗した場合は負の値を返す。ス 
テータス情報は上位がメッセージインフエーズで得た情報，下位がステータスイ 
ンフ I ーズで得た情報である。 

注 意一 _ s CS i _ rea S sigii 関数は SCSI デバイスドライバを登録することにより，初めて使 
用することができる。登録されていない場合，その動作は一切保証されないので 
注意すること。 

規 格一 Project LIBC Group , XC 

関埋項目- _ scsi - select , _ scsi _ testiin.it 
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Chapter 5—SCSI コールライブラリ 


scsi request 


用 途- SCSI ュニットのセンスデータを調べる。 

書 式- #include < sys / scsi . h > 

mt _ scsi_request (int n , int id , void * buff ); 

解 説—— _ scsi_request 関数は， / •ゴで指定した SCSI ID の SCSI ユニットの REQUEST SENSE 
データを 《 バイト分読み込み，が指す領域に格納する。 

戻り値——正常終了した場合はステータス情報を返し，失敗した場合は負の値を返す。ス 
テータス情報は上位がメッセージインフ1ーズで得た情報，下位がステータスイ 
ンフヱーズで得た情報である。 

注 意一 -scsijrequest 関数は SCSI デバイスドライバを登録することにより，初めて使 
用することができる。登録されていない場合，その動作は一切保証されないので 
注意すること。 

bujfit. 最低でも17以上の大きさの領域を指していなければならない。 

規 格- Project LIBC Group , XC 

関連項目- _ scsi _ select ，_ scsi_testunit 
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ライブラリー第 2 部 


scsi reset 


用 途 —— SPCfSCSI プロトコルコントローラ）の リセットおよび SCSI バスの リセットを 
行ぅ。 

書 式- # include < sys / scsi . h > 

void _ scsi_reset ( void ); 

解 説—— _ scsi _ reset 関数は SPC ( SCSI プロトコルコントローラ）のリセットおよび SCSI 
バスのリセットを実行し，バスリセット後2秒間待機する。 

戻り値一なし。 

注 意—— _ scsi _ reset 関勢は SCSI デバイスドライバを登録することにより，初めて使用 

することができる。登録されていない場合，その動作は一切保証されないので注 
意すること。 

規 格 —— Project LIBC Group , XC 

関埋項目- - scsi — select , _ scsi_testunit 
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Chapter 5—SCSI コーノレライブラリ 


scsi —rezerounit 


用 途—— SCSI ュニットを指定の状態にセットする。 

書式- #include < svs / scsi . h > 

int _ scsi_rezerounit (mt id ); 

解 説—— _ scsi_rezero 皿 it 関数は， / ゴで指定した SCSI ID の SCSI ユニットを指定した 

状態にセットする。 

戻り値——正常終了した場合はステータス情報を返し，失敗した場合は負の値を返す。ス 
テータス情報は上位がメッセージインフ I ーズで得た情報，下位がステータスイ 
ンフエーズで得た情報である。 

注 意一 _ scsi _ xezer 0 皿 it 関数は SCSI デバイスドライバを登録することにより，初めて 

使用することができる。登録されていない場合，その動作は一切保証されないの 
で注意すること。 

規 格 —— Project LIBC Group , XC 

関連項目- _ scsi _ select , _ scsi_testunit 
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ライブラリー第 2 部 


—scsi—seek 


用 途 —— SCSI ュニッ トを指定の論理ブロックにシークする。 

書 式- # include < sys/scsi . h > 

int _ scsi_seek (int pos,int id ); 

解 説—— _ scsi _ seek 関数は， / ゴで指定した SCSI ID の SCSI ユニットを pay (論理ブロッ 
ク番号）の位置にシークする。 

戻り値——正常終了した場合はステータス情報を返し，失敗した場合は負の値を返す。ス 
テータス情報は上位がメッセージインフエーズで得た情報，下位がステータスイ 
ンフエーズで得た情報である。 

注 意—— _ scsi _ seek 関数は SCSI デバイスドライバを登録することにより，初めて使用す 
ることができる。登録されていない場合，その動作は一切保証されないので注意 
すること。 

規 格一 Project LIBC Group , XC 

関連項目- _ scsi _ select , _ scsi_testunit 
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Chapter 5 — SCSI コーノレライブラリ 


select 


用 途—アービトレーシヨンフェーズとセレクシヨンフェーズを実行する。 

書 式 -- #include <sys/scsi .h> 

int _scsi_select ^int id); 

解 説 —— _scsi_select 関数は/ゴで指定した SCSI ID の SCSI ユニットに 対して， アービ 
トレー シヨン フェーズとセレ クシヨン フェーズを 実行する。 

戻り値——正常終了した場合は〇を返し，失敗した場合はその原因を示す SCSI エラーコー 
ドを返す。 

注 意—— _ scs i_sel e ct 関数は SCSI デバイスドライバを登録することにより，初めて使用 
することができる。登録されていない場合，その動作は一切保証されないので注 
意すること。 

規 格- Project LIBC Group , XC 

関連項目- _scsi_testunit 
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ライブラリー第 2 部 


scsi—startstop 


用 途—— SCSI ユニットに対して，以降の操作を可能または不可能にする。 

書 式- # include < sys/scsi . h > 

int _ scsi_st art stop ^mt mode , mt id ); 

解 説——胃 scsi _ startstop 関数は，/ゴで指定した SCSI ID の SCSI ユニットの操作モード 

を mode とする。 mode が0ならば操作不可能，1ならば操作可能となる。 

戻り値——正常終了した場合はステータス情報を返し，失敗した場合は負の値を返す。ス 
テータス情報は上位がメッセージインフエーズで得た情報，下位がステータスイ 
ンフエーズで得た情報である。 

注 意- _ scsi _ startstop 関数は SCSI デバイスドライバを登録することにより，初めて 

使用することができる。登録されていない場合，その動作は一切保証されないの 
で注意すること。 

規 格一 Project LIBC Group , XC 

関埋項目- _ scsi _ select , _ scsi_testunit 
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Chapter 5—SCSI コールライブラリ 


scsistsin 


用 途— ステータス イン フヱーズを 実行する。 

式- frinc 丄 ude < sys / scsi . h > 

mt _ scsi_stsin (void * buff ); 

解 説 - _ scsi_stsin 関数はステータスインフエーズを実行し，か/ガが指す領域に1バイ 

卜のデータを SCSI バス 上から読み込む。 

戻り値——正常終了した場合は0を返し，失敗した場合はその原因を示す SCSI エラーコー 
ドを返す。 

注 意一 - scsi—stsin 関数は SCSI デバイスドライバを登録することにより，初めて使用 
することができる。登録されていない場合，その動作は一切保証されないので注 
意すること。 

buff は， 最低でも1バイト以上の大きさの領域を指していなければならない。 

規 格- Project LIBC Group , XC 

関埋項目- - scsi — select , _ scsi_test 皿 it 
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ライブラリー第 2 部 


scsi—testumt 


用 途—— SCSI ュニットが動作可能かどうかを調べる。 

書 式- # include < sys / scsi . h > 

int . scsi.testunit unt id ); 

解 説一 _ scsi _ testunit 関数は， / ゴで指定した SCSI ID の SCSI ユニットが動作可能か 

どうかを調べる。 

戻り値——動作可能ならば〇を返し，それ以外ならばステータス情報を返す。ステータス 
情報は上位が メッセージインフエー ズで得た情報，下位が ステータスインフエー 
ズで得た情報である。 

注 意—— _ scsi _ testunit 関数は SCSI デバイスドライバを登録することにより，初めて使 
用することができる。登録されていない場合，その動作は一切保証されないので 
注意すること。 

規 格- Project LIBC Group , XC 

関連項目- _ scsi_select 
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Chapter 5—SCSI コールライブラリ 


_scsi—write 


用 途- SCSI ュニッ トに データを 書き込む。 

式- #mclude く svs / scsi . n > 

int _ scsi_write ^int pos , int blk , 

int id , int size , const void * buff ); 

解 説—— _ scsi_write 関数は叫がが指す領域のデータを，/ゴで指定した SCSI ID の SCSI ユ 

ニットの/ 70 S (論理ブロック番号）の位置から，6/た(論理ブロック数） x * si ^(0=256, 
1=512, 2=1024) バイト分書き込む。 

戻り値——正常終了した場合は ステータス 情報を返し，失敗した場合は負の値を返す。 ス 
テータス 情報は上位がメ ッ セージインフヱーズで得た情報，下位がステ ータ スイ 
ンフ I ーズで得た情報である。 

注 意—— - scsi-write 関数は SCSI デバイスドライバを登録することにより，初めて使用 

することができる。登録されていない場合，その動作は一切保証されないので注 
意すること。 

buff は， 結果を格納するだけの十分な大きさの領域を指していなければならない。 

規 格- Project LIBC Group , XC 

関浬項目- _ scsi _ select , _ scsi_testunit 
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ライブラリー第 2 部 


—scs ■一 writeext 


用 途——拡張 WRITE コマン ドで SCSI ユニッ トにデータを書き込む。 

書式-# include < sys/scsi . h > 

int _ scsi_writeext (int pos,int blk , 

int id , int size , const void * buff ); 

解 説—— _ scsi _ writeext 関数は如ガ'か指す領域のデータを，/ゴで指定した SCSI ID の SCSI 

ユニットの pos (論理 ブロック番号） の位置から，わ/た(論理ブロック数) X 沧 e (0= 256 , 
1=512, 2=1024) バイト分書き込む。論理ブロック数は65535ブロックまで指定 
可能。 

戻り値——正常終了した場合はステータス情報を返し，失敗した場合は負の値を返す。ス 
テータス情報は上位がメッセージインフエーズで得た情報，下位がステータスイ 
ンフヱーズで得た情報である。 

bujJU ， 結果を格納するだけの十分な大きさの領域を指していなければならない。 

注 意—— _ scsi . writeext 関数は SCSI デバイスドライバを登録することにより，初めて使 
用することができる。登録されていない場合，その動作は一切保証されないので 
注意すること。 

規 格 —— Project LIBC Group , XC 
関埋項目- _ scsi - select ，_ scsi_testunit 
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Chapter 6 


幅広文字ライブラリ 


本章には幅広文字（ワイドキャラクタ）ライブラリのマニュアルを掲 
載します。 LIBC では ^/^(Multibyte Support Extension ) や SVR 4, 
0 SF /1 で規定されている幅広文字関数群のうち，有用と思われる約40の 
関数を提供しています。 

ANSI C でも 幅広文字についてはまだ取り入れられただけであり，詳し 
い関数の規格などは現在検討されている状況です0しかし現実レベルで 
は OSF /1, そして MS 五などでどんどん幅広文字関数が取り入 
れられています0 L 7 BC ではこういったことをふまえ，完全ではないにし 
ろ幅広文字をサボートすることにしました。 

基本的には普通の文字列を扱う関数と同じですから，慣れてしまえば初 
心者にとっても扱いやすいものです。よく マニュアルを 読んで使用してく 
ださい。ただし，これらの幅広文字に関しては将来正式な規格が制定さ 
れた段階で，変更されることがあります。あらかじめ注意してください0 




























































































































































































































































ライブラリー第 2 部 



用 途——ファイルストリームから1幅広文字を取り出す。 

書 式-# include く widec.li> 

wint_t fgetwc (FILE *stream) ; 

解 説—— fgetwc 関数は，灯/^ w で指定されたファイルストリームから 1 幅広文字を wchar_t 
型のデータとして取り出し，それを W int_t 型に変換して返す。ストリームのファ 
イルポインタは，これに応じて1幅広文字分進む。 

戻り値——正常に取り出せた場合はそのデータを返す。もしストリーム操作中に，何らかの 
エラーが発生した場合はストリームの エラー 指示子を設定して WEOF を返し， ファ 
イルの終端に到達した場合はストリームの終端指示子を設定して WEOF を返す。 
失敗した場合は，変数 eirno にその原因を示すエラーコードを設定する。 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

規 格 —— Project LIBC Group , SYSV 

関連項目- getwc 
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Chapter 6 —幅広文字ライブラリ 



用 途ーファイルストリームから幅広文字列を取り出す。 


■rf 式- #mclude く widec . h > 

char *fgetws ( wchar.t * s , int n , FILE * stream ); 


解 説—— fgetws 関数は打/^ wz で指定されたファイルストリームから幅広文字列を取り出 

し，結果を s が指す領域に格納する。幅広文字列の取り出しは n -1 幅広文字を処 
理するか，ファイルの終端に到達するか，改行文字を処理するまで続けられる。 
結果の幅広文字列には改行文字が含まれ，最後に mill 文字が置かれることに注意 
すること。 



戻り値一正常に幅広文字列を取り出せた場合は J を返す。もしストリーム操作中に，何ら 
かのエラーが発生した場合はストリームのエラー指示子を設定して NULL を返し， 
ファイルの終端に到達した場合はストリームの終端指示子を設定して NULL を返 
す。失敗した場合は，変数 errno にその原因を示すエラーコードを設定する。 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 


注 意一^は少なくとも《幅広文字分の領域を指していなければならない。 

規 格 —— Project LIBC Group，SYSV 
関連項目- ferror , fread , getws 
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ライブラリー第 2 部 



用 途——ファイルストリームに幅広文字を出力する。 

書 式-# include く widec.li> 

wint_t fputwc (wint.t wc, FILE *stream); 

解 説- fputwc 関数は打 mmi で指定されたファイルストリームに対して，幅広文字 wc 

を wchar_t 型に変換して出力する。これに応じて，ストリームのファイルポイン 
夕は1幅広文字分進む。なお，ストリームが追加モードでオープンされている場 
合，出力はすべてファイルの最後尾に追加される形式で実行される。 

戻り値一正常に出力できた場合は⑽を返し，何らかの エラーに よって失敗した場合は，ス 
トリームのエラー指示子を設定して WEOF を返す。失敗した場合は，変数 errno 
に その原因を示す エラーコー ドを設定する。 

• EBADF ファイルス トリ ームに 関連す るファイルハンドルがおかしい 

• EN0SPC ディスクが一杯である 

規 格 —— Project LIBC Group，SYSV 

関埋項目- ferror, fopen, putwc, putws 


818 





Chapter 6 —幅広文字ライブラリ 



用 途ーファイルストリームに幅広文字列を出力する。 


書 式- #include く widec . li > 

int fputws Qconst wchar_t * s , FILE * stream ); 

解 説- fputws 関数は於/^で指定されたフアイルストリームに対して，が指す幅広 

文字列を出力する。幅広文字列は null 文字までとし，最後の null 文字は出力し 
ない。なお，ストリームが追加モードでオープンされている場合，出力はすべて 
ファイルの最後尾に追加される形式で実行される。 



戻り値——正常に出力できた場合は負ではない値を返し，何ら かのエラーに よって失敗した 
場合は ストリームの エラー指示子を設定して EOF を返す。失敗した場合は，変数 
errno にその 原因を示す エラーコード を設定する。 

• EBADF ファイルストリームに関連するフアイルハンドルがおかしい 


規 格 —— Project LIBC Group，SYSV 

関連項目—— ferror , fopen ， putwc , putws 
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ライブラリー第 2 部 



用 途——ファイルストリームから1幅広文字を取り出す。 

書 式-# include <widec .h> 

wint_t getwc (FILE *stream); 

解 説—— getwc 関数は，打/枚で指定されたファイルストリームから 1 幅広文字を wctiar_t 

型のデータとして取り出し，それを wint_t 型に変換して返す。ストリームのファ 
イルポインタは，これに応じて1幅広文字分進む。 

戻り値——正常に取り出せた場合はそのデータを返す。もしストリーム操作中に，何らかの 
エラーが発生した場合はストリームの エラー 指示子を設定して WEOF を返し，ファ 
イルの終端に到達した場合はストリームの終端指示子を設定して WEOF を返す。 
失敗した場合は，変数 erriio にその原因を示すエラーコードを設定する。 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

注 意- getwc 関数はつねに fgetwc 関数の別名である 0 

規 格 —— Project LIBC Group，SYSV 

関連項目- fgetwc 
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Chapter 6 —幅広文字ライブラリ 


getwchar 


用 途一標準入カファイルストリームから1幅広文字を取り出す。 


書式- #include < widec . h > 

wmt_t getwchar vvoid ); 

解 説—— getwchar 関数は，標準入力に割り当てられたファイルストリームから1幅広文 
字を W cliar _ t 型のデータとして取り出し，それを wint _ t 型に変換して返す。ス 
トリームのファイルポインタは，これに応じて1幅広文字分進む。 

getwchar 関数は， fgetwc 関数に stdin を指定した場合と同じことである。 

戻り値一正常に取り出せた場合はそのデータを返す。もしストリーム操作中に，何らかの 
エラーが発生した場合は標準入カストリームのエラー指示子を設定して WE0F を 
返し，ファイルの終端に到達した場合はストリームの終端指示子を設定して WE0F 
を返す。失敗した場合は，変数 errno にその原因を示すエラーコードを設定する。 

• EBADF フアイルストリームに関連するフアイルハンドルがおかしい 



注 意—— getwchai •関数はつねにマクロとして定義される 0 

規 格 —— Project LIBC Group，SYSV 

関連項目- fgetwc , getwc 
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ライブラリー第 2 部 



用 途——標準入カファイルストリームから幅広文字列を取り出す。 

書 式- #include く widec . h 〉 

wchar.t *getws ( wchar.t * s ); 

解 説—— getws 関数は標準入力に割り当てられたファイルストリームから幅広文字列を取 
り出し，結果を J が指す領域に格納する。幅広文字列の取り出しはファイルの終 
端に到達するか，改行文字に到達するまで続けられる。結果の幅広文字列には改 
行文字は含まれず，最後に null 文字が置かれることに注意すること。 

戻り値——正常に幅広文字列を取り出せた場合にはを返す。もしストリーム操作中に，何 
らかのエラーが発生した場合はストリームのエラー指示子を設定して NULL を返 
し，ファイルの終端に到達した場合はストリームの終端指示子を設定して NULL を 
返す。失敗した場合は，変数 errno にその原因を示すエラーコードを設定する 0 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

注 意—— getws 関数は fgetws 関数とは異なり，結果の幅広文字列に改行文字を含まない 
ことに注意する。また J は結果を格納するのに十分な領域を指していなければな 
らない。 

規 格 —— Project LIBC Group , SYSV 

関連項目- ferror , fread 
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Chapter 6 一 幅広文字ライブラリ 


iswalnum 


用 途——英数字かどうかを調べる。 

書式- #include <wwctype . h > 

mt iswalnum ( wint_t c ); 


解 説 一 iswalnum 関数は c で指定した文字コードを，現在のロケールの LC _ CTYPE カテゴ 

リに照らし合わせ，英数字であるかどうかを調べる。 


戻り値—— c が英数字ならば0以外の値を返し，異なれば〇を返す。 

注 意一通常， iswalnum 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE „ が定義 

されると実体をもつ関数となる。 iswalnum 関数がマクロとして展開される場合 
は，引数が副作用を伴わないように注意すること。 

•は C ロ ケールしかサボートしていない。 



規 格 —— Project LIBC Group , SYSV 


関連項目- iswalpha , iswascii , iswcntrl ， iswdigit , lswgraph , lswlower ， lswprint , 

iswpunct ， iswspace ， iswupper ， iswxdigit 
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ライブラリー第 2 部 


iswalpha 


用 途——アルファべットかどうかを調べる。 

書 式- # include < wctype . h > 

int iswalpha ( wmt_t c ); 

解 説一 iswalpha 関数は C で指定した文字コードを，現在のロケールの LC — CTYPE カテゴ 

リ に 照らし合わせ，英字 （アルファべ ット）であるかどうかを調べる。 

戻り値一 C が英字（アルファベット）ならば0以外の値を返し，異なれば〇を返す。 

注 意——通常， iswalpha 関数はマクロとして定義されるが， _ JIO _ CTYPE _ INLINE __ が定義 

されると実体をもつ関数となる。 iswalpha 関数がマクロとして展開される場合 
は，引数が副作用を伴わないように注意すること。 

L 仿 C は C ロケールしかサポートしていない。 

規 格 —— Project LIBC Group，SYSV 

関連項目- iswalnum , iswascii , iswcntrl , iswdigit , iswgraph , lswlower , lswpnnt , 

iswpunct , iswspace ， iswupper , iswxdigit 
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Chapter 6 —幅広文字ライブラリ 


iswascn 


用 途——7ビット ASCII 文字かどうかを調べる。 

書式- #inc 丄 ude < wctype . h > 

int lswascn ( wint_t c ); 

解 説—— iswascii 関数は c で指定した文字コードが ，7 ビット ASCII 文字 （0 x 00 〜 0 x 7 F ) 
であるかどうかを調べる。 

戻り値—— c が7ビット ASCII 文字ならば0以外の値を返し，異なれば0を返す。 

注 意一通常， iswascii 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義 
されると実体をもつ関数となる。 iswascii 関数がマクロとして展開される場合 
は，引数が副作用を伴わないように注意すること。 

iswascii 関数はロケールとは関係がない。 

規 格 —— Project LIBC Group , XPG 3, AES / OS , 4.3 BSD，SYSV 

関連項目- iswalnum , iswalpha , iswcntrl ， iswdigit , iswgraph , iswlower , iswprint , 

iswpnnct , iswspace , iswnpper , iswxdigit 
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ライブラリー第 2 部 


iswcntrl 


用 途—制御文字かどうかを調べる。 

書 式- # include < wctvpe . h > 

int iswcntrl ^ wmt_t c ); 

解 説一 iswcntrl 関数は c で指定した文字コードを，現在のロケールの LC . CTYPE カテゴ 

リに照らし合わせ，制御文字 （コン トロール文字）であるかどうかを調べる。 

戻り値—— C が制御文字ならば0以外の値を返し，異なれば0を返す。 

注 意——通常， iswcntrl 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義 

されると実体をもつ関数となる。 iswcntrl 関数がマクロとして展開される場合 
は，引数が副作用を伴わないように注意すること。 

LffiC は C ロケールしかサポートしていない。 

規 格 —— Project LIBC Group , SYSV 

関連項目- iswalnum , iswalpha , iswascii ， iswdigit , iswgraph , iswlower , lswpnnt , 

iswpunct , iswspace , iswupper , iswxdigit 
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Chapter 6 —幅広文字ライブラリ 


iswdigit 


用 途——数字かどうかを調べる。 

書式- #include < wctype . h > 

int iswdigit ( wint^t c ); 

解 説—— iswdigit 関数は c で指定した文字コードを，現在のロケールの LC — CTYPE カテゴ 

リに照らし合わせ，数字であるかどうかを調べる。 

戻り値—— c が数字ならば0以外の値を返し，異なれば〇を返す。 

注 意——通常， iswdigit 関数はマクロとして定義されるが， -_ NO _ CTYPE _： INLINE __ が定義 

されると実体をもつ関数となる。 iswdigit 関数がマクロとして展開される場合 
は，引数が副作用を伴わないように注意すること。 

L / SC は C ロケールしかサポートしていない。 

規 格- Project LIBC Group , SYSV 

関連項目—— iswalnum , iswascii , iswcntrl , iswgraph , iswlower , iswprint , iswpunct , 
iswspace , iswupper , iswxdigit 
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ライブラリー第 2 部 


iswqraph 


用 途一表示可能文字かどうかを調べる。 

書 式- # include < wctype . h > 

int iswgraph ( wint_t c ;; 

解 説一 iswgraph 閨数は C で指定した文字コードを，現在のロケールの LC — CTYPE カテゴ 

リに照らし合わせ，表示可能文字 （スペースを 除く印字可能文字）であるかどうか 
を調べる。 

戻り値—— c が表示可能文字ならば0以外の値を返し，異なれば〇を返す。 

注 意一通常， iswgraph 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE — が定義 

されると実体をもつ関数となる。 iswgraph 関数がマクロとして展開される場合 
は，引数が副作用を伴わないように注意すること。 

は C ロケールしかサポートしていない。 

規 格 —— Project LIBC Group , SYSV 

関連項目- iswalmun , iswalpha , iswascii ， iswcntrl , iswdigit , iswlower , iswprint , 

iswpunct , iswspace , iswupper , iswxdigit 
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Chapter 6 一 幅広文字ライブラリ 


iswlower 


用 途——英小文字かどうかを調べる。 

書 式- #include < wctype . h > 

int iswlower ( wint_t c ); 

解 説一 iswlower 関数は c で指定した文字コードを，現在のロケールの LC — CTYPE カテゴ 

リに照らし合わせ，英小文字であるかどうかを調べる。 

戻り値一 c が英小文字ならば0以外の値を返し，異なれば0を返す。 

注 意——通常， iswlower 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義 
されると実体をもつ関数となる。 iswlower 関数がマクロとして展開される場合 
は，引数が副作用を伴わないように注意すること。 

ZJBC は C ロケールしかサポートしていない。 

規 格 —— Project LIBC Group, SYSV 

関連項目—— iswalnum , iswalpha , iswascii , iswcntrl , iswdigit , iswgraph , iswprint , 
iswpunct , iswspace ， iswupper , iswxdigit 
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ライブラリー第 2 部 


iswprint 


用 途——英大文字かどうかを調べる。 

書 式- #include く wctype . li > 

int iswprint ^ wint_t c ); 

解 説一 iswprint 関数は C で指定した文字コードを，現在のロケールの LC — CTYPE カテゴ 

リに照らし合わせ，印字可能文字であるかどうかを調べる。 

戻り値—— c が印字可能文字ならば0以外の値を返し，異なれば〇を返す。 

注 意一通常， iswprint 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義 

されると実体をもつ関数となる。 iswprint 関数がマクロとして展開される場合 
は，引数が副作用を伴わないように注意すること。 

•は C ロケールしかサポートしていない。 

規 格一 Project LIBC Group，SYSV 

関連項目- iswalnum , iswalpha , iswascii , iswcntrl , iswdigit , iswgraph , iswlower ， 

iswpunct , iswspace , iswupper , iswxdigit 


830 





Chapter 6 —幅広文字ライブラリ 


iswpunct 


用 途—記号文字かどうかを調べる。 

式- #mclude く wctvpe . h 〉 

mt iswpunct (wmt_t c); 

解 説- iswpunct 関数は C で指定した文字コードを，現在のロケールの LC _ CTYPE カテゴ 

リに照らし合わせ，記号文字であるかどうかを調べる。 

戻り値—— C が記号文字ならば0以外の値を返し，異なれば0を返す。 

注 意——通常， iswpunct 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義 
されると実体をもつ関数となる。 iswpunct 関数がマクロとして展開される場合 
は，弓 I 数が副作用を伴わないように注意すること。 

•は C ロケールしかサボートしていない。 

規 格一 Project LIBC Group , SYSV 

関埋項目- lswalnum, lswalpha, lswascii ， lswcntrl, lswdigit, lswgraDh, lswlower, 

iswprint, iswspace ， iswupper ， iswxdigit 
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ライブラリー第 2 部 


iswspace 


用 途——空白文字かどうかを調べる。 

書 式- - #include く wctype . h 〉 

int iswspace ( wint_t c ); 

解 説—— iswspace 関数は C で指定した文字コードを，現在のロケールの LC — CTYPE カテゴ 

リに照らし合わせ，空白文字（スペース/タブ/改行/復帰/垂直タブ/改頁など）で 
あるかどうかを調べる。 

戻り値—— c が記号ならば0以外の値を返し，異なれば0を返す。 

注 意——通常， iswspace 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義 
されると実体をもつ関数となる。 iswspace 関数がマクロとして展開される場合 
は，引数が副作用を伴わないように注意すること。 

ZJJ 5 C は C ロケールしかサポートしていない。 

規 格一 Project LIBC Group , SYSV 

関連項目- lswalnum , lswalpha ， lswascii ， iswcntrl , lswaigit , lswgraph , lswlower , 

iswprint , iswpunct , iswupper ， iswxdigit 
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Chapter 6 —幅広文字ライブラリ 


iswupper 


用 途—英大文字かどうかを調べる。 


僅 式- #mclude <wctype . h > 

int iswupper ( wint_t c ); 


解 説—— iswupper 関数は C で指定した文字コードを，現在のロケールの LC - CTYPE カテゴ 

リに照らし合わせ，英大文字であるかどうかを調べる。 


戻り値—— C が英大文字ならば0以外の値を返し，異なれば0を返す。 

注 意——通常， iswupper 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義 
されると実体をもつ関数となる。 iswupper 関数がマクロとして展開される場合 
は，引数が副作用を伴わないように注意すること。 

LIBC は C ロケールしかサポートしていない。 



規 格 —— Project LIBC Group，SYSV 

関埋項日- lswalnum , lswalplia , lswascii , lswcntrl , lswdigit , lswgraph , iswlower ， 

iswprint , iswpunct , iswspace , iswxdigit 
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iswxdiait 


用 途——16進数字かどうかを調べる。 

僅 式- # include < wctype . h > 

int lswxdigit ( wint_t c ); 

解 説—— iswxdigit 関数は c で指定した文字コードが，16進数字であるかどうかを調べ 
る。16進数字とは〇〜9と A 〜 F ， a 〜 f のことを指す。 

戻り値—— c が16進数字ならば0以外の値を返し，異なれば0を返す。 

注 意——通常， iswxdigit 問数はマクロとして定義されるが， 一 NO _ CTYPE _ INLINE __ が定 
義されると実体をもつ関数となる。 iswxdigit 関数がマクロとして展開される場 
合は，引数が副作用を伴わないように注意すること。 

iswxdigit 関数はロケールとは関係がない。 

規 格一 Project LIBC Group , SYSV 

関連項目- iswa 丄 num ， lswalpha ， lswascn , iswcntrl , lswaigit , lswgraDh , lswlower , 

iswprint , iswpunct , iswspace , iswupper 
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Chapter 6 —幅広文字ライブラリ 



用 途 ファイルストリームに幅広文字を出力する。 


書式- #include <widec . h > 

wmt_t putwc ( wint_t wc , FILE * stream ); 

解 説- putwc 関数は stream で指定されたファイルストリームに対して，文字 wc を 

wchar-t 型に変換して出力する。これに応じて，ストリームのファイルポイン 
夕は1幅広文字分進む。なお，ストリームが追加モードでオーブンされている場 
合，出力はすべてファイルの最後尾に追加される形式で実行される。 


戻り値一正常に出力できた場合は⑽を返し，何らかのエラーによって失敗した場合は，ス 
トリームのエラー指示子を設定して WEOF を返す。失敗した場合は，変数 errno 
にその原因を示すエラーコードを設定する。 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

• EN 0 SPC ディスクが一杯である 


注 意—— putwc 関数はつねに fgetwc 関数の別名である。 
規 格 —— Project LIBC Group , SYSV 
関連項目 ^ -fputwc 
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ライブラリー第 2 部 


putwchar 


用 途——標準出カファイルストリームに幅広文字を出力する。 

書 式- #include く widec . h 〉 

wint_t putwchar ( wmt.t wc ); 

解 説一 putwchar 関数は標準出力に割り当てられたファイルストリームに対して，⑽を 

wchar - t 型に変換して出力する。これに応じて，ストリームのファイルポイン 
夕は1幅広文字分進む。なお，ストリームが追加モードでオープンされている場 
合，出力はすべてファイルの最後尾に追加される形式で実行される。 

putwchar 関数は， fputwc 関数に stdout を指定した場合と同じになる。 

戻り値——正常に出力できた場合は wc を返し，何らかのエラーによって失敗した場合は，標 
準出カストリームのエラー指示子を設定して WE 0 F を返す。失敗した場合は，変 
数 errno にその原因を示すエラーコードを設定する。 

• EBADF ファイルストリームに関連するファイルハンドルがおかしい 

• EN 0 SPC ディスクが一杯である 

注 意—— putwchar 関数はつねにマクロとして定義される。 

規 格 —— Project LIBC Group、SYSV 

関連項目- fputwc , putwc 
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用 途——標準出カファイルストリームに幅広文字列を出力する。 

書 式- #include <widec . h > 

int Dutws 、 const wchar_t *s ノ； 

解 説—— putws 関数は標準出力に割り当てられたファイルストリームに対して， J が指す 

幅広文字列と改行文字を出力する。幅広文字列は null 文字までとし，最後の null 
文字は出力しない。なお，ストリームが追加モードでオープンされている場合, 
出力はすべてファイルの最後尾に追加される形式で実行される。 

putws 関数は fputws 関数とは異なり，幅広文字列の最後に改行文字を付加して 
出力する。 

戻り値一正常に出力できた場合は負では ない 値を返し，何ら かのエラーに よって失敗した 
場合は， ストリームの エラー指示子を設定して EOF を返す。失敗した場合は，変 
数 errno にその 原因を示す エラーコー ドを設定する。 

• EBADF ファイルストリームに関連するフアイルハンドルがおかしい 


規 格^— Project LIBC Group , SYSV 

関連項目—— ferror ， fopen , fputws , putwc 
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ライブラリー第 2 部 


towlower 


用 途——大文字を小文字に変換する。 

書 式-# include <wctype . h > 

wint^t towlower ^ wint^t c ); 

解 説一 towlower 関数は c で指定された文字を，現在のロケールの LC_CTYPE カテゴリに 
したがって大文字から小文字に変換する。ただし，変換は大文字に対してのみ行 
われ，それ以外の文字は変化しない。 

戻り値一 C を小文字に変換した文字を返す。 

注 意——通常， towlower 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義 

されると実体をもつ関数となる。 towlower 関数がマクロとして展開される場合 
は，引数が副作用を伴わないように注意すること。 

は C ロケールしかサポートしていない。 

規 格 —— Project LIBC Group，SYSV 

関連項目- towupper 
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Chapter 6 —幅広文字ライブラリ 


towupper 


用 途一小文字を大文字に変換する。 

邊 式- #mclude < wctype . h > 

wmt_t towupper ^ wmt_t c ); 

解 説—— towupper 関数は c で指定された文字を，現在のロケールの LC - CTYPE カテゴリに 

したがって小文字から大文字に変換する。ただし，変換は小文字に対してのみ行 
われ，それ以外の文字は変化しない。 

戻り値—— c を大文字に変換した文字を返す。 

注 意——通常， towupper 関数はマクロとして定義されるが， __ NO _ CTYPE _ INLINE __ が定義 
されると実体をもつ関数となる。 towupper 関数がマクロとして展開される場合 
は，引数が副作用を伴わないように注意すること。 

は C ロケールしかサポートしていない。 

規 格 —— Project LIBC Group，SYSV 

関連項目- towlower 
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unqetwc 


用 途——入カファイルストリームに幅広文字を押し戻す。 

書 式"- #include く widec . li > 

int ungetwc ( wchar.t wc , FILE * stream ); 

解 説- ungetwc 関数は，於/で am で指定された入力用のファイルストリームに we を押し 

戻す。ただし，に EOF を指定した場合は何も行わない。 

押し戻されたデータは後に続く読み出し操作で最優先に取り出されることになる 
が，あくまでもバッファ上の操作であり，ファイルの実体は一切変更されない。 
また押し戻しが行われた後は，ストリームに設定されていた終端指示子はクリア 
される。 

戻り値一正常に押し戻せた場合は⑽を int 型に変換して返し，失敗した場合は EOF を 
返す。 

注 意—— ungetwc 関数は最低限1幅広文字を押し戻せることを保証しているが，それ以上 

については，状況によっては押し戻せないことがあるので注意すること。 

規 格 —— Project LIBC Group , SYSV 

関連項目- fseek , fsetpos ， getwc , rewind , setbuf , ungetwc 
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wcscat 


用 途—文字列をほかの文字列に連結する。 


書式- #include < wstring . h > 

wchar_t * wcscat 、 wchar_t * stnngl,const wchar^t * string 2); 


解 説一 wcscat 関数は，於/ 7>2 g 2 の指す文字列をの指す文字列の最後にコピーし， 

連結した文字列の最後に null 幅広文字をつける。 string 1の未尾の null 幅広文字 
には， 於/ 7>2於2の最初の文字を重ねて コピーす る。 


戻り値——你へのポインタを返す。 


注 意—— string ! ( i , 連結した結果の文字列を格納するに十分な領域を指していなければな 

らない。1文字は1幅広文字を意味する。 


規 格一 MSE 


関連項目- wcsncat 
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ライブラリー第 2 部 


wcschr 


用 途—文字列中から指定文字を検索する。 

書 式- #include < wstring . h > 

wchaLT_t *wcschr (const wchar__t * string , wint_t character ); 

解 説一 wcschr 関数は价/叩が指す文字列中から，•で指定された文字を検索す 

る。打/末尾の null 幅広文字も検索の対象となり得る。 character は， 内部で 
wint_t 型から wchar.t 型に変換される。 

戻り値-打/ 7>2 g 中で最初に現れた Mamcfer へのポインタを返す。見つからない場合は NULL 

を返す。 

注 意——1文字は1幅広文字を意味する。 

規 格—— MSE 

関連項目- wcscspn , wcspbrk ， wcsrchr ， wcsspn，wcstok 
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wcscmp 


用 途一2つの文字列を比較する。 


■rf 式- #mclude < wstring . h > 

mt wcscmp (const wchar_t * stringl , const wchar.t * string 2); 

解 説- wcscmp 関数は，打バ《ざ7の指す文字列とが/ •/« が 2 の指す文字列を比較する。比較は， 

null 幅広文字が検出された時点で終了する。 


戻り値——比較の結果，2つの文字列がまったく同じならば0を返す。異なる場合，その位置 
での打/側の幅広文字が灯 r //2 g 2 側の幅広文字よりも大きければ正の値を，小 
さければ負の値を返す。 


注 意——1文字は1幅広文字を意味する。 


規 格 —— MSE 


関連項目- wcsncmp 
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ライブラリー第 2 部 


wcscoll 


用 途——2つの幅広文字列をロケールを用いて比較する。 

書 式' # include < wstring . h > 

int wcscoll (const wchar_t * stringl,const wchar.t * strmg 2); 

解 説—— wcscoll 関数は， stringl の指す幅広文字列と於/7>?ル2の指す幅広文字列を現在の 
ロケールの LC - COLLATE カテゴリを基に比較する。比較は， null 幅広文字が検出 
された時点で終了する。 

戻り値——比較の結果，2つの幅広文字列がまったく同じならば0を返す。異なる場合，そ 
の位置での对側の幅広文字が灯/*/側の幅広文字よりも大きければ正の値 
を，小さければ負の値を返す。 

注 意——は C ロケールしかサポートしていないので， strcmp 関数と同じである。1 
幅広文字は1バイトを意味する。 

規 格一 Project LIBC Group , MSE 

関埋項目- wcscmp , wcsxfrm 
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wcscpy 


用 途一文字列をコピーする。 


書式- #include < wstring . h > 

wchar_t * wcscpy 、 wcnar _ t : * stringl , const wchax_t * string 2); 

解 説- wcscpy 関数は打/7>2ざ2の指す文字列を， null 幅広文字を含めて string 1 の指す領域 

にコピーする。 


戻り値 一你/呢7へのポインタを返す。 

注 意——領域が重なっていた場合の動作は未定義である。 また string 〗 は， 於/7>7ぎ2の指す 

文字列を格納するのに十分な領域を指していなければならない。1文字は1幅広 
文字を意味する。 


規 格 —— MSE 


関連項目- wcsncpy 



845 






ライブラリー第 2 部 


wcscspn 


用 途——指定文字列に含まれない文字が，ほかの文字列の先頭から何文字続いているかを 

調べる。 

書 式- # include < wstring . h > 

size.t wcscspn (const wchar 一 t * stringl,const wchar.t * stnng 2); 

解 説—— wcscspn 関数は string ! の指す文字列と切かがの指す文字列を比較し， string 1の 

先頭から string ! に含まれな V 、文字で構成されている部分の長さを調べる。 

戻り値 —— stringl の失 M から， 打/7>2がに含まれない文字で構成されている部分の長さを返す。 

注 意——1文字は1幅広文字を意味する。 

規 格—— MSE 

関連 1 貝目- wcschr , wcspbrk , wcsrchr , wcsspn , wcstok 
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Chapter 6 —幅広文字ライブラリ 


用 途一新しい領域を確保して文字列をコピーする。 

谨エ t - #mclude < wstring . h > 

wchar_t *wcsduD (const wchar_t * string ); 

解 説- wcsdup 関数は打/か茗の指す文字列を， null 幅広文字を含めて malloc 関数によっ 

て確保した領域にコピーする。 

戻り値——正常にコピーできた場合はコピー先へのポインタを返し，失敗した場合は NULL 
を返して，変数 eixno にその原因を示すエラーコードを設定する 0 

• EN 0 MEM メモリが足りなくなった 

注 意一1文字は1幅広文字を意味する。 

規 格- Project LIBC Group 

関連項目- malloc , wcscpy 
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wcslen 


用 途——文字列の長さを調べる。 

舊式- # inc 丄 ude < wstrmg . h > 

size_t wcslen cconst wchar_t ^ string ); 

解 説一 wcslen 関数は，打/ 7>2 g の指す文字列末尾の null 幅広文字を除いた文字列の長さを 
調べる。 

戻り値——末尾の null 幅広文字を除いた文字列の長さを返す。 

注 意一1文字は1幅広文字を意味する。 

規 格 ——MSE 
関連項目- wcscpy 
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Chapter 6 —幅広文字ライブラリ 


wcsncat 


用 途一文字列を指定文字数だけほかの文字列に追加する。 

違式- frinc 丄 ude < wstrincr . h > 

wchar_t *wcsncat twchar 一 t * stringl , const wchar_t * string 2, 
size_t n ); 

解 説- wcsncat 関数は，对 r />7 ぎ 2 の指す文字列を s び//^/の指す文字列の最後にコピーし， 

連結した文字列の最後に null 幅広文字をつける。打/7>级7の末尾の mill 幅広文字 
には，打/7>2がの最初の文字を重ねてコピーする。コピーは null 幅広文字が検出さ 
れるか，《文字コピーした時点で終了する。 

戻り値- 对/7>2ぎ/へのポインタを返す。 

注 意—— stringl は ，連結した結果の文字列を格納するのに十分な領域を指していなければ 

ならない。1文字は1幅広文字を意味する。 

規 格一 MSE 

関連項目- wcscat 



849 





ライブラリー第 2 部 


wcsncmp 


用 途一2つの文字列を指定文字数だけ比較する。 

書 式- # include < wstring . h > 

int wcsncmp (const wchar_t * stringl , const wchar_t * string 2, 
size_t n ); 

解 説—— wcsncmp 関数は，打/*/呢7の指す文字列と打/ */« がの指す文字列を比較する。比較 
は mill 幅広文字が検出されるか，《文字比較した時点で終了する。 

戻り値——比較の結果，2つの文字列がまったく同じならば0を返す。異なるか n 文字を比 
較し終えた場合，その位置でのが/7>^バ則の文字が於/7>2客2側の文字よりも大きけ 
れば正の値を，小さければ負の値を返す。 

注 意-1文字は1幅広文字を意味する。 

規 格一 MSE 

関連項目- wcscmp 
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Chapter 6 —幅広文字ライブラリ 


wcsncpy 


用 途一文字列を指定文字数だけコピーする。 

■rf 式- #mclude < wstring . h > 

wchar^t *wcsncpy (, wchar_t * stringl , const wchar_t 木 string 2, 
size_t n ); 

解 説—— wcsncpy 関数は打/7>2客2の指す文字列の最初の《文字までを，於 rz >2 g / の指す領域 

にコピーする。コピーは null 幅広文字が検出されるか，《文字コピーした時点で 
終了する。 

戻り値- 打へのポインタを返す。 


注 意 一 領域が重なっていた場合の動作は未定義である。また於/ V > Zg 7 は，《文字を格納す 

るのに十分な領域を指していなければならない。1文字は1幅広文字を意味する。 

規 格 —— MSE 

関連項目- wcscpy 
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ライブラリー第 2 部 


wcspbrk 


用 途——指定文字列に含まれる文字がほかの文字列に存在するかどうかを調べる。 

書 式- # include < wstring . h > 

wchar_t *wcspbrk (const wchar.t * stnngl , 
const wchax_t * string 2); 

解 説一 wcspbrk 関数は，打 r / 叹 7 の指す文字列と打の指す文字列を比較し， string 2 

に含まれる文字が最初に現れる場所を検索する。 

戻り値——-对/*/叩7中で， string ! に含まれる文字が最初に現れる位置へのポインタを返す。見 
つからない場合は NULL を返す。 

注 意一1文字は1幅広文字を意味する。 

規 格 —— MSE 

連項目- wcschr , wcscspn , wcsrchr , wcsspn , wcstok 
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Chapter 6 —幅広文字ライブラリ 


wcsrchr 


用 途——文字列中から指定文字が最後に現れる位置を検索する。 

■rf エ、 - #inc 丄 ude < wstring . h > 

wchar_t *wcsrchr (const wchar_t 木 strincr . wint 一 t character ); 

解 説^— wcsrchr 関数は於/ */« ぎの指す文字列中から， c/zorac 如*で指定された文字が最後 

に現れる位置を検索する。於/かぎ末尾の null 幅広文字も検索の対象となり得る。 
character は ,内部で wint_t 型から wchar_t 型に変換される。 


戻り値- 切*/叹 中で最後に現れるへのポインタを返す。見つからない場合は NULL 

を返す。 


注 意——1文字は1幅広文字を意味する。 


規 格一 MSE 


関埋項目- wcschr , wcscspn , wcspbrk , wcsspn , wcstolt 
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ライブラリ ー 第2部 


wcsspn 


用 途——指定文字列に含まれる文字が，ほかの文字列の先頭から何文字続いているかを調 

ベる0 

書 式- # include < wstring . h > 

size.t wcsspn (const wchar.t * stringl , const wchar.t * stnng 2；; 

解 説一 wcsspn 関数は， stringl の指す文字列と边7>2がの指す文字列を比較し ， string I の 
先頭から stringl に含まれる文字で構成されている部分の長さを調べる。 

戻り値一打/7>2ぎ7の先頭から，於/7>2がに含まれる文字で構成されている部分の長さを返す。 

注 意——1文字は1幅広文字を意味する。 

規 格—— MSE 

to 連項目- wcschr ， wcscspn , wcspbrk , wcsrchr , wcstok 
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Chapter 6 —幅広文字ライブラリ 


wcstod 


用 途一幅広文字列を double 型倍精度浮動小数に変換する。 

•rf - #mclude < wstnng . h > 

double wcstod ^const wchar_t *nDtr, wchar_t **endptr ノ； 

解 説—— wcstod 関数は叩かで指定された幅広文字列を，まず3つの部分文字列すなわち 

先頭の空白部分，浮動小数部分，認識不能部分（終端の null 幅広文字を含む）に 
分割する。 wcstod 関数はこれらの部分文字列のうち，浮動小数部分の文字列を 
double 型倍精度浮動小数に変換し，その値を返す。 

この浮動小数部分は符号（省略可能)，浮動小数および指数（省略可能）からなり， 
指数部分は“ e ” か“ E ” に続いて符号（省略可能）と指数値からなる。 

-3.1415926, 1.8794 E +15, 2.42 e -6 

もし⑼办かが NULL でない場合は，⑼办かに最後の認識不能部分へのポインタを 
格納する。この部分は終端の null 文字を含むため，1文字以上になる。 

小数点として認識する文字は，ロケールの LCJJUMERIC カテゴリに影響される。 

戻り値一変換した結果を返す。ただし結果がオーバーフローした場合は HUGE—VAL を返し， 
アンダーフロー した場合は0を返して，変数 errno にその原因を示すエラーコー 
ドを設定する。 

即びが空文字であったり，すべて空白だったり，認識不能文字だったりして浮動 
小数部分の文字列が見つからない場合は変換は行われず，〇を返す。また，この 
とき endptr には nptr の値が格納される。 


• ERANGE オーバーフロー あるいはアンダー フローを 起こした 


注 意——は C ロケールしかサポートしていない。 

規 格- Project LIBC Group , MSE 

関連項目 - wcstol, wcstoul 
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ライブラリ ー 第2部 


wcstok 


用 途——文字列を指定した区切り文字でトークンに分ける。 

書式- #include < wstring . h > 

wchar_t *wcstok (, wchar_t ^ string , const wchar.t *de 丄 inu ; 

解 説—— wcstok 関数を連続して呼ぶことにより，对/7>2ぎが指す文字列を語句（卜ークン）に 
分解することができる。各語句は，み/^が指す文字列に含まれる区切り文字（デ 
リミタ）によって区切られる。 

最初に wcstok 関数を呼び出すときは，デリミタ文字列をぎに指定する。以 
降， wcstok 関数を呼び出すときには，打/ • Zwg に NULL を指定する。デリミタ文字 
列は， wcstok 関数を呼び出すたびに変えることが可能。於;7>7客にデリミタ文字列 
が続く場合は無視される。 

戻り値——語句が見つかれば，最後の区切り記号の位置に null 幅広文字を設定し，語句の最 
初の文字へのポインタを返す。見つからなければ NULL を返す。 

注 意- wcstok 関数は与えられたが/ 7>2どの 領域を書き換えるので，元のデータが必要な場 

合は自分で保存しておく必要がある。1文字は1幅広文字を意味する。 

規 格—— MSE 

関埋ェ貝目- wcschr , wcscspn , wcspbrk , wcsrchr , wcsspn , wcstok 
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Chapter 6 —幅広文字ライブラリ 


wcstol 


用 途——幅広文字列を long 型整数に変換する。 


谱 式- #inciude < wstring . h > 

long wcstol (const wchar.t * nptr , wchar.t 本* endptr , int radix ); 

解 説- wcstol 関数は叩ひで指定された幅広文字列を，まず3つの部分文字列すなわち 

先頭の空白部分，整定数部分，認識不能部分（終端の null 幅広文字を含む）に分割 
する。 wcstol 関数はこれらの部分文字列のうち，整定数部分の文字列を ， radix 
で指定した値を基数として101 ig 型整数に変換し，その値を返す。 

整定数部分は符号（省略可能）から始まり，基数が1〜10ならば〇〜9の文字を, 
また基数が10〜36ならばこれに加えて A 〜 Z および a 〜 z の文字が数値とし 
て認識される。 

もし基数 radix が0の場合， 入力文字列の基数は8,10，16のいずれかであり， 
文字列の特徴から動的に決定される。すなわち01〜07から始まれば8， Ox から 
始まれば16,それ以外ならば10である。また基数が16の場合は，接頭辞 Ox も 
数値の一部として認識される。 

ただし，数値の最後の u ， U ， 1， L などの皿 signed 型指定文字， long 型指定文 
字は数値としては認識されないので注意すること。 

endptr が mJLL でない場合は，⑼办かに最後の認識不能部分へのボインタを格納 
する。この部分は終端の null 文字を含むため，1文字以上になる。 


戻り値一変換した結果を返す。ただし結果が long 型で表現しきれない場合は，符号に応 
じて L 0 NGJ 1 AX あるいは L 0 NG _ MIN を返し，変数 errno にその原因を示すエラー 
コードを設定する。 

即ぴが空文字だったり，すべて空白だったり，認識不能文字だったりして整定数 
部分の文字列が見つからない場合，変換は行われず〇を返す。また，このとき 
endptr には 叩 / r の値が格納される。 

• ERANGE 変換結果が101 ig 型で表現することができない 

注 意—— LIBC は C ロ ケールしかサポートしていない。 



規 格^一 Project LIBC Group，MSE 


関連項目- wcstod , wcstoul 
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ライブラリー第 2 部 


wcstoul 


用 途-幅広文字列を unsigned 10 ng 型整数に変換する。 

僅 式- # include < wstnng . h > 

unsigned long wcstoul (const wchar 一 t * nptr , wchar_t ** endptr , 

int radix ); 

解 説 —— wcstoul 関数はで指定された幅広文字列を，まず3つの部分文字列すなわち 

先頭の空白部分，整定数部分，認識不能部分（終端の null 幅広文字を含む）に分割 
する。 wcstoul 関数はこれらの部分文字列のうち，整定数部分の文字列を ， radix 
で指定した値を基数として皿 signed 10 ng 型整数に変換し，その値を返す。 

整定数部分は符号（省略可能）から始まり，基数が1〜10ならば〇〜 9 の文字を， 
また基数が10〜36ならばこれに加えて A 〜 Z および a 〜 z の文字が数値とし 
て認識される。 

もし基数⑺め ； c が0の場合は，入力文字列の基数は8,10，16のいずれかであり， 
文字列の特徴から動的に決定される。すなわち01〜07から始まれば8, Ox から 
始まれば16，それ以外ならば10である。また基数が16の場合は，接頭辞 Ox も 
数値の一部として認識される。 

ただし，数値の最後の u ， U ， 1， L などの unsigned 型指定文字， long 型指定文 
字および負の符号“-”は数値としては認識されないので注意すること。 

⑽办かが NULL でない場合は，⑼办かに最後の認識不能部分へのボインタを格納 
する。この部分は終端の null 文字を含むため，1文字以上になる。 

戻り値-変換した結果を返す。ただし結果が unsigned long 型で表現しきれない場合は 

UL 0 NG 上 AX を返し，変数 errno にその原因を示すエラーコードを設定する。 

•が空文字だったり，すべて空白だったり，認識不能文字だったりして整定数 
部分の文字列が見つからない場合，変換は行われず0を返す。また，このとき 
endptr には の値が格納される。 


• ERANGE 変換結果が unsigned long 型で表現することができない 

注 意——は C ロケールしかサポートしていない。 

規 格一 Project LIBC Group , MSE 
関連項目- wcstod , wcstol 
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Chapter 6 —幅広文字ライブラリ 


WCSWCS 


用 途——指定文字列がほかの文字列に存在するかどうかを調べる。 

書式- #include < wstring . h > 

size_t wcswcs (const wchar^t * stringl , const wchar.t * strmg 2); 

解 説- wcswcs 関数は string I の指す文字列と灯/の指す文字列とを比較し， string 1 

中で，文字列 string 2 が最初に現れる位置を検索する。 

戻り値一打/ */« ぎ7中で，打/かジが最初に現れる位置へのポインタを返す。 

注 意一1文字は1幅広文字を意眛する。 

規 格一 MSE 

関連項目- wcschr ， wcspbrk , wcsrchr ， wcsspn，wcstok 
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ライブラリー第 2 部 


wcsxfrm 


用 途-2つの幅広文字列をロケールを用いて指定の巾 S 仏文字数たけコピーする。 

書 式-# include く wstring . li > 

size_t wcsxfrm ( wchar.t * stringl , const wchar.t * string 2, 
size.t n ); 

解 説—— wcsxfrm 関数は，打/7せ2が指す幅広文字列の最初から《幅広文字を現在のロケ ー 

ルの LC _ COLLATE カテゴリを基に変換し，打ゾの指す領域にコピーする。コ 
ピーは null 幅広文字が検出されるか，《幅広文字コピーした時点で終了する。 
对/ 7 > 2 容 2 末尾の null 幅広文字も変換の対象となり得る。また《が〇の場合， stringl 
は NULL でもよい。 

戻り値一変換された幅広文字の文字数 （ null 幅広文字は含まない）を返すが，《が〇の場合 
は単に string 2 の長さ を返す。 

注 意——領域が重なっていた場合の動作は未定義である 。また stringl は， 打/を変換 

した幅広文字列を格納するのに十分な領域を指していなければならない。 

は C ロケールしかサポートしていないので，基本的には strncpy 関数と同 
じである。1文字は1バイトを意味する。 

規 格 —— Project LIBC Group , MSE 

関連項目- wcscoll，wcsncpy 
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ライブラリー第 2 部 



❖ 数値演算 


- fpu-off 数学ライブラリを FLOAT パッケージ呼び出しにする•…78 

- fpu-on 数学ライブラリを数値演算コプロセッサ直接駆動にする..79 


- is 68881 数値演算コプロセッサの種類を調べる . 167 

abs int 型の値の絶対値を取得する . 6 

acos 逆余弦 arccos (: r ) を求める . 8 

acosh 双曲逆余弦を求める . 9 

asin 逆正弦 arcsin (: r ) を求める . 13 

asinh 双曲正弦 arcsin / i ( x ) を求める . 14 

at an 逆正接 ar * c ^ an ( x ) を求める . 16 

atan 2 逆正接を求める . 17 

at anh 双_逆正接 arc ^ m / i ( T ) を求める . 18 

atof 文字列を double 型倍精度浮動小数に変換する . 20 

atoi 文字列を符合つき int 型整数に変換する . 21 

atol 文字列を符合つき long 型整数に変換する . 22 

ceil : r 以上の整数のなかで最も小さな数を返す . 29 

cos 余弦 cos ( x ) を求める . 43 

cosh 双曲余弦 cos / i (: r ) を求める . 44 

div int 型整数の除算を行う . 54 

drand 実数の乱数を生成する . 55 

ecvt 浮動小数値を指数形式の数字列に変換する . 61 

exp e x を求める . 77 

fabs x の絶対値を返す . 82 

fcvt 浮動小数値を数字列に変換する . 88 

floo r エ以下の整数のなかで最も大きな数を返す . 1〇〇 

fmo d z / y の剰余を返す . 1〇2 

fre xp 浮動小数点値を仮数部と指数部に分ける . 118 

gcvt 浮動小数値を G フォーマット形式の文字列に変換する..131 

isinf 無限大かどうかを調べる . 18 〇 
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Chapter 7 — Appendix A 


isnan 非数かどうかを調べる . 183 

labs long 型の値の絶対値を取得する . 192 

Idexp x に 2 ea:p を乗じた値を返す . 193 

ldiv long 型整数の除算を実行する . 195 

log 自然対数/叩(〇〇を求める . 198 

loglO 常用対数 kp 10 ( rr ) を求める . 199 

max 2つの最大値を求める . 208 

min 2つの最小値を求める . 218 

modf 整数部と小数部にわける . 222 

pow 累乗を求める . 235 

rand 整数の乱数を生成する . 247 

random 整数の乱数を生成する . 248 

sin 正弦 sin ( x ) を求める . 295 

sinh 双曲正弦 sin / i ( x ) を求める . 297 

sqrt 平方根を求める . 311 

srand 乱数シードを初期化する . 312 

srandom 乱数シードを初期化する . 313 

strtod 文字列を double 型倍精度浮動小数に変換する . 343 

strtol 文字列を long 型整数に変換する . 345 

strtoul 文字列を unsigned long 型整数に変換する . 346 

tan 正接 tan ( x ) を求める . 358 

tanh 双曲正接を求める . 360 

wabs short 型の値の絶対値を取得する . 393 


❖プロセスの環境設定•取得 


clearenv プロセスの環境変数テーブルをクリアする . 37 

fpathconf パス名に関する情報を取り出す . 106 

getenv 環境変数の値を取得する . 140 

getopt 引数配列からオプション文字列を解析する . 148 

getrlimit システム制限値を取得する . 158 

pathconf パス名に閨する情報を取り出す . 231 

putenv 環境変数を登録/変更/削除する . 241 

setrlimit システム制限値を再設定する . 275 

sysconf システムに関する情報を取り出す . 351 

uname システムに関する情報を取り出す . 377 
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❖ コンソール直接入出力 


cgets コンソールから直接1行入力する . 30 

cprintf 直接コンソールへフォーマット出力する . 45 

cputs 直接コンソールへ1行出力する . 46 

getch コンソールから直接1文字を入力する（エコーなし）.133 

getche コンソールから直接1文字を入力する（エコーあり）-135 

kbhit コンソールへの入力の有無を調べる . 190 

putch コンソールへ直接1文字を出力する . 239 

ungetch コンソールにデータを押し戻す . 379 


❖文字の判定と変換 


.tolower 大文字を小文字に変換する . 355 

_toupper 小文字を大文字に変換する . 357 

isalrmm 英数字かどうかを調べる . 172 

is alpha アルファべットかどうかを調べる . 173 

isascii 7ビット ASCII 文字かどうかを調べる . 174 

isblank ブランク文字かどうかを調べる . 176 

iscntrl 制御文字かどうかを調べる . 177 

isdigit 数字かどうかを調べる . 178 

isgraph 表示可能文字かどうかを調べる . 179 

isiso 8ビット ISO 文字かどうかを調べる . 181 

islower 英小文字かどうかを調べる . 182 

isodigit 8進数字かどうかを調べる . 184 

isprint 印字可能文字かどうかを調べる . 185 

ispunct 記号文字かどうかを調べる . 186 

isspace 空白文字かどうかを調べる . 187 

isupper 英大文字かどうかを調べる . 188 

isxdigit 16進数字かどうかを調べる . 189 

toascii 7ビット ASCII 文字に変換する . 367 

toiso 8ビット ISO 文字に変換する . 368 

tolower 大文字を小文字に変換する . 369 

toupper 小文字を大文字に変換する . 370 





































♦ i ♦低水準ファイル入出力とファイル名操作 


—addlastsep パス名の最後にパス区切り記号を付加する . 4 

.dellastsep パス名の最後のパス区切り記号を削除する . 52 

_fullentry ファイル名をフルパスに展開する . 80 

-fullpath ファイル名をフルパスに展開する . 81 

-getdriveno ファイル名から論理ドライブ番号を求める . 129 

_makepath パスの各要素からパス名を構成する . 204 

_ mode2dos ファイルモードを披張 UNIX アクセスモードから 

DOS ファイルアトリビュートに変換する . 205 

_ mode2unix ファイルモードを DOS ファイルアトリビュートから 

拡張 UNIX アクセスモードに変換する . 206 

_splitpath パスを構成要素に分解する . 261 

_sysroot 環境変数 SYSR 00 T を用いてパス名を再構成する……264 

.tobslash パス名に含まれるパス区切り記号をバックスラッシュに 

変換する . 354 

.toslash パス名に含まれるパス区切り記号をすべてスラッシュに 

変換する . 356 

access ファイルにアクセスできるかどうかを調べる . 7 

chdir カレントワーキングディレクトリを変更する . 31 

chdrive カレントドライブを変更する . 32 

chmod ファイルのアクセスモードを変更する . 34 

chown ファイルのオーナーおよびグループを変更する . 35 

chsize ファイルの長さを変更する . 36 

close ファイルをクローズする . 40 

closedir ディレクトリストリームをクローズする . 41 

commit ファイルアクセスのバッファをフラッシュする . 42 

creat 新しいファイルの作成と書き込みモードでオープンする47 

dup ファイルハンドルを複製する . 56 

dup2 ファイルハンドルを複製する . 57 

f chmod ファイルのアクセスモードを変更する . 83 

f chown ファイルのオーナーおよびグループを変更する . 84 

fcntl ファイルとファイルハンドルの操作を行う . 87 

filelength ファイルの長さを求める . 98 

f truncate ファイルの長さを変更する . 127 

getcwd カレントワーキングディレクトリを取得する . 136 

getdcwd 指定ドライブのカレントワーキングディレクトリを 

取得する . 137 

get , drive カレントドライブを取得する . 138 








































isatty 端末デバイスであるかどうかを調べる . 175 

lockino * ファイル中の領域ロックの設定/解除を実行する- 197 

Iseek ファイルボインタの位置を再設定する . 202 

mkdir ディレクトリを作成する . 219 

mktemp テンポラリファイル名を作成する . 220 

open ファイルを才ープンする . 226 

opendir ディレクトリストリームをオープンする . 228 

read ファイルから読み込む . 250 

readdir 次のディレクトリストリームの内容を読み込む . 251 

readlink シンボリックリンクファイルのリンク先を取得する • 252 

remove ファイル/ディレクトリを削除する . 254 

rename ファイル名を変更する . 255 

rewinddir ディレクトリストリームの位置を先頭に戻す . 257 

rmdir ディレクトリを削除する . 259 

seekdir ディレクトリストリームの位置を変更する . 267 

stat ファイルのステータス情報を取得する . 315 

symlink シンボリックリンクファイルを作成する . 350 

tell ファイルポインタの位置を調べる . 361 

telldir ディレクトリストリームのポインタ位置を返す . 362 

truncate ファイルの長さを変更する . 371 

umask ファイルモードの新規作成用マスクを設定する . 376 

unlink ファイルを削除する . 380 

utime ファイルのタイムスタンプを変更する . 382 

write フアイルへ書き込む . 396 


❖割り込み処理 


IJUMP rts 命令を用いた大域ジャンプを実行する . 163 

IJUMP_RTE 割り込みルーチンの宣言と rte 命令へのジャンプを 

実行する . 164 

IRTE 割り込みルーチンの宣言と rte 命令による復帰を 

実行する . 165 

IRTS 全レジスタを保存する関数を宣言する . 166 

PRAMREG パラメータレジスタ渡しのためのレジスタを指定する 229 

RETREG パラメータレジスタ渡しのためのレジスタを指定する 245 

SET_FRAME フレームポインタに使用するレジスタを指定する .…260 

intlevel CPU ステータスレジスタの割り込みマスクを設定する 170 



































Chapter 7 — Appendix A 


❖大域ジャンプ 


longjmp 大域ジャンプを実行する . 201 

setjmp 大域ジャンプ用のジャンプポイントを設定する . 271 

siglongjmp 大域ジャンプを実行する . 288 

sigsetjmp 大域ジャンプ用のジャンプポイントを設定する . 293 


❖ メモリ管理 


alloca スタックフレームからメモリを割り当てる . 11 

brk ブレーク値を設定する . 25 

calloc メモリブロックを確保する . 28 

chkml 空きメモリ容量をバイト単位で調べる . 33 

free メモリブロックを解放する . …115 

malloc メモリブロックを確保する . 207 

rbrk ブレーク値をリセットする . 249 

realloc メモリブロックを再確保する . 253 

sbrk ブレーク値を変更する . 265 

sizmem 空きメモリ容量をロングワード単位で調べる . 298 


❖ プロセス操作 


abort カレントプロセスを異常終了させる . 5 

assert プログラム診断を行う . 15 

atexit プロセス終了時に呼び出される関数を登録する . 19 

execl プログラムを実行する . 66 

execle プログラムを実行する（環境指定） . 67 

execlp プログラムを実行する（パス指定） . 69 

execv 引数配列でプログラムを実行する . 71 

execve 弓 I 数配列でプログラムを実行する（環境指定） . 72 

execvp 引数配列でプログラムを実行する（パス指定） . 74 

exit プロセスを終了させる . 76 
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nice 

onexit 

spawnl 

spawnle 

spawnlp 

spawnv 

spawnve 

spawnvp 

system 


カレントプロセスの優先度を変更する . 223 

プロセス終了時に必ず呼び出される関数を登録する • 225 

子プロセスを実行する . 300 

子プロセスを実行する（環境指定） . 301 

子プロセスを実行する（パス指定） . 303 

引数配列で子プロセスを実行する . 305 

引数配列で子ブロセスを実行する（環境指定） . 306 

引数配列で子プロセスを実行する（ハ°ス指定） . 308 

シェルコマンドを実行する . 352 


❖シグナル操作 


alarm アラームシグナルを設定する . 1〇 

kill プロセスに対してシグナルを送信する . 191 

pause シグナルを受信するまでプロセスの実行を中断する. 233 

psignal 標準出力にシグナルメッセージを出力する . 237 

raise 自プロセスに対してシグナルを発行する . 246 

sigaction シグナル発生時の動作を再設定または取得する……280 

sigaddset シグナルセットへの追加を実行する . 282 

sigblock シグナルをブロックする . 283 

sigdelset シグナルセットからの削除を実行する . 284 

sigemptyset シグナルセットの初期化を実行する . 285 

sigfillset シグナルセットを初期化し，すべてのシグナルを 

設定する . 286 

sigismember シグナルセットに指定したシグナルが設定されているか 

どうかを調べる . 287 

signal シグナルハンドラを設定または登録する . 289 

sigpending 現在ペンデイング状態にあるシグナルのセットを 

取得する . 291 

sigprocmask ブロックシグナルセットを取得または変更する . 292 

sigsusDend シグナルが配信されるのを侍つ . 294 



































❖ ソート 


bsearch ソート済みの配列に対してバイナリサーチを行う….26 

qsort 配列をクイックソートによって整列させる . 244 


❖標準ファイル入出力 


clearerr ファイルストリームのエラーおよび終端指示子を 

クリアする . 38 

eprintf 標準エラー出カファイルストリームにフォーマット 

出力を行う . 65 

f close ファイルストリームをクローズする . 85 

fcloseall すべてのファイルストリームをクローズする . 86 

fdopen ファイルハンドルに対するファイルストリームを 

オープンする . 89 

feof ファイルストリームの終端指示子を調べる . 91 

f error ファイルストリームのエラー指示子を調べる . 92 

f flush . ファイルストリームをフラッシュする . 93 

fgetc ファイルストリームから1バイトを取り出す . 95 

fgetpos ファイルストリームのファイルポインタの位置を 

取得する . 96 

fgets ファイルストリームから文字列を取り出す . 97 

f ileno ファイルストリームに関連するファイルハンドルを 

取得する . 99 

flushall すべてのファイルストリームをフラッシュする . 101 

fmode ファイルストリームの変換モードを変更する . 103 

fopen ファイルストリームをオープンする . 104 

fprintf 指定したファイルストリームにフォーマット出力を 

行う . 108 

fputc ファイルストリームにバイトデータを出力する . 112 

fputs ファイルストリームに文字列を出力する . 113 

f read ファイルストリームからデータ列を取り込む . 114 

f reopen ファイルストリームを再才ープンする . 116 

f scanf 指定したファイルストリームからフォーマット入力を 

行う . 119 

































fseek ファイルストリームのファイルポインタの位置を再設定 

する . 123 

fsetDos ファイルストリームのファイルポインタの位置を 

元に戻す . 124 

ftell ファイルストリームのファイルポインタの位置を 

取得する . 125 

f write ファイルストリームにデータ列を書き込む . 128 

getc ファイルストリームから1バイトを取り出す . 132 

get char 標準入カファイルストリームから1バイトを取り出す134 

gets 標準入カファイルストリームから文字列を取り出す.159 

getw ファイルストリームからヮードデータを取り出す ••• 161 

perror 標準出力にエラーメッセージを出力する . 234 

printf 標準出カファイルストリームにフォーマット出力を 

行う . 236 

putc ファイルストリームにバイトデータを出力する . 238 

put char 標準出カファイルストリームにバイトデータを 

出力する . 240 

puts 標準出カファイルストリームに文字列を出力する ...242 

putw ファイルストリームにヮードデータを出力する……243 

rewind ファイルストリームのファイルポインタを先頭に戻す256 

scanf 標準入カファイルストリームからフォーマット入力を 

行う . 266 

setbuf ファイルストリームにバッファを割り当てる . 268 

setmode ファイルの変換モードを変更する . 272 

setvbuf ファイルストリームにバッファを割り当てる . 278 

sprintf 文字列に対してフォーマット出力を行う . 310 

sscanf 文字列からフォーマット入力を実行する . 314 

tempnam テンポラリファイル名を作成する . 363 

tmpfile テンポラリファイルを作成する . 365 

tmpnam テンポラリファイル名を作成する . 366 

unget c 入カファイルストリームにデータを押し民す . 378 

vfprintf 可変長引数リストをフォーマット出力する . 387 

vf scanf ファイルストリームから可変長引数リストを用いて 

フォーマット入力を実行する . 388 

vprintf 可変長引数リストをフォーマット出力する . 389 

vscanf 標準入カファイルストリームから可変長引数リストを 

用いてフォーマット入力を実行する . 390 

vsprintf 可変長引数リストをフォーマット出力する . 391 

vsscanf 文字列から可変長引数リストを用いてフォーマット 

入力を実行する . 392 
































❖文字列とメモリ領域の操作 


bcmp 2つの領域の内容を比較する . 23 

bcopy 領域をコピーする . 24 

bzero 領域を0で埋める . 27 

ffs セットされたビットを検索する . 94 

index 文字列中から指定文字を検索する . 169 

memccpy 指定文字まで領域をコピーする . 212 

memchr 領域中から指定文字を検索する . 213 

memcmp 2つの領域の内容を比較する . 214 

memcpy 領域をコピーする . 215 

memmove 領域をコピーする . 216 

memset 領域を指定文字で埋める . 217 

rindex 文字列中から指定文字が最後に現れる位置を検索する258 

strcat 文字列をほかの文字列に連結する . 318 

strchr 文字列中から指定文字を検索する . 319 

strcmp 2つの文字列を比較する . 320 

strcmpi 2つの文字列を大文字と小文字を区別しないで 

比較する . 321 

strcoll 2つの文字列をロケールを用いて上匕較する . 322 

strcpy 文字列をコピーする . 323 

strcspn 指定文字列に含まれない文字が，ほかの文字列の先頭 

から何文字続いているかを調べる . 324 

strdup 新しい領域を確保して文字列をコピーする . 325 

strerror エラーメッセージへのポインタを返す . 326 

strftime 詳細時間の情報を文字列に変換する . 327 

stricmp 2つの文字列を大文字と小文字を区別しないで 

比較する . 329 

strlen 文字列の長さを調べる . 330 

strlwr 文字列を小文字に変換する . 331 

st meat 文字列を指定文字数だけほかの文字列につけ加える. 332 

strnemp 2つの文字列を指定文字数だけ比較する . 333 

strnepy 文字列を指定文字数だけコピーする . 334 

striiset 文字列を指定文字で指定文字数分たけ埋める . 335 

strpbrk 指定文字列に含まれる文字がほかの文字列に存在するか 

どうかを調べる . 336 

strrehr 文字列中から指定文字が最後に現れる位置を検索する337 

strrev 文字列を前後反転させる . 338 

strset 文字列を指定文字で埋める . 339 







































strsignal シグナルを表す文字列を取得する . 340 

strspn 指定文字列に含まれる文字が，ほかの文字列の先頭から 

何文字続いているかを調べる . 341 

strstr 指定文字列がほかの文字列に存在するかどうかを 

調べる . 342 

strtok 文字列を指定した区切文字でトークンに分ける……344 

strupr 文字列を大文字に変換する . 347 

strxfrm 2つの文字列をロケールを用いて指定文字数たけ 

コ tf * — . 348 

swab 文字を交換する . 349 


❖時間の取得と設定 


_getleaps 指定した年までの閏年の回数を調べる . 130 

_isleap 閏年補正の必要性について調べる . 168 

asctime 日付データを文字列に変換する . 12 

clock 起動してから現在までの経過時間を測定する . 39 

ctime 日付データを文字列に変換する . 49 

difftime 2つの時刻の差を計算する . 53 

ftime 現在の時刻を取得する . 126 

gmtime 曆時間を協定世界時間 （ UTC ) に変換する . 162 

localtime 暦時間を地域時間に変換する . 196 

mktime 地域時間を暦時間に変換する . 221 

sleep 秒単位のスリープを実行する . 299 

time 現在時刻を取得する . 364 

tzset タイムゾーン情報（地域時間情報）を初期化する……373 

usleep マイクロ秒単位のスリープを実行する . 381 


♦J ♦ユーザデバイス管理 


ctermid 現在の コントロール 端末の名称を取得する . 48 

cuserid ユーザのログイン名を取得する . 50 

endgrent グループファイルへのアクセスを終了する . 62 

endpwent ノヽ。スワードファイルへのアクセスを終了する . 63 





































getegid 実効グループ ID を取得する . 139 

geteuid 実効ユーザ ID を取得する . 141 

getgid 実グループ ID を取得する . 142 

getgrent グループファイルから1データを取り出す . 143 

getgrgid グループファイルからグループ ID でデータを検索する145 

getgrnam グループファイルからグループ名でデータを検索する146 

getlogin ユーザのログイン名を取得する . 147 

getpgrp プロセスグループ ID を取得する . 151 

getpid プロセス ID を取得する . 152 

getppid 親プロセス ID を取得する . 153 

getpwent パスワードファイルから1データを取り出す . 154 

getpwnam パスワードファイルからユーザ名でデータを検索する156 

getpwuid パスワードファイルからユーザ HD でデータを検索する157 

getuid 実ユーザ ID を取得する . 160 

setgid グループ ID を変更する . 269 

setgrent グループファイルへのアクセスをファイル先頭に戻す270 

setpgid プロセスグループ ID を変更する . 273 

setpwent パスワードファイルへのアクセスをファイル先頭に 

戻す . 274 

setsid 新しいプロセスグループ ID を形成する . 276 

setuid ユーザ ID を変更する . 277 

ttvname S 末のデバイス名を調べる . 372 


❖その他 


off setof 構造体メンバのオフセットを求める . 224 

va_arg 可変長引数リストから引数を1つ取り出す . 383 

va_end 可変長引数リストへのアクセスを終了する . 385 

va_start 可変長引数リストへのアクセスを開始する . 386 
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DOS コ 


_ dos_allclose オープンしているすべてのフ ァイ ルを クローズ する 398 

_ dos_assign 仮想ドライブ/仮想ディレクトリの割り当てリストの 

取得/作成/解除を行う . 399 

_ dos_breakck ブレークチヱックを設定する . 401 

_ dos _ change_pr バックグラウンドプロセスの実行権を放棄する . 402 

_ dos_chdir カレントディレクトリを変更する . 403 

_ dos_chgdrv カレントドライブを変更する . 404 

_ dos_chmod ファイル属性を変更する . 405 

_ dos_cinsns RS -232 C からの入力が可能かどうかを調べる . 406 

_ dos-close ファイルをクローズする . 407 

_ dos_cominp RS -232 C から1文字入力する . 408 

_ dos_common Human68k の common 領域を操作する . 409 

_ dos_comout RS -232 C へ1文字出力する . 411 

_ dos_conctrl CON デバイスの出力を直接制御する . 412 

_ dos_consns 画面への出力が可能かどうかを調べる . 416 

_ dos_coutsns RS -232 C への出力が可能かどうかを調べる . 417 

_ dos_create ファイルを新規に作成する . 418 

_ dos_ctlabort CTRL+C アボート处理へジャンプする . 419 

_ dos_curdir カレントディレクトリを取得する . 420 

_ dos_curdrv カレントドライブの番号を調べる . 421 

_ dos_delete ファイルを削除する . 422 

_ dos_diskred ブロックデバイスへの直接入力を行う . 423 

_ dos_diskwrt ブロックデバイスへの直接出力を行う . 424 

_ dos_drvctrl ドライブ状態のチエックおよび設定を行う . 425 

_ dos_drvxchg ドライブを入れ替える . 427 

_ dos_dskfre ディスクの残り容量を調べる . 428 

_ dos_dup ファイルハンドルを複写する . 429 

dos dupO ファイルハンドルを強制的に複写する . 430 

_ dos _ dup2 ファイルハンドルを複写する . 431 

_ dos_errabort エラーアボート处理へジャン プする . 432 

_ dos_exec プログラムをロード/実行する . 433 

_ dos_exit 現在のプロセスを終了し，親プロセスへ復帰する...436 

_ dos _ exit2 現在のプロセスを終了し，親プロセスへ復帰する ...437 









































_dos_fatchk 指定ファイルの使用セクタが連続しているかどうかを 

調べる . 438 

_dos_fatchk2 指定ファイルの使用セクタが連続しているかどうかを 

調べる . 439 

_dos_fflush. ディスクのリセットを行う . 440 

_dos_fgetc ファイルハンドルから 1 バイ ト 入力する . 441 

_dos_fgets ファイルハンドルから文字列を入力する . 442 

_dos_filedate ファイル日付/時刻の読み込みと設定を行う . 443 

_dos_files ファイルを 検索す る . 444 

_dos_fnckey 再定義可能キーの読み込み/設定を行う . 446 

_dos_fputc ファイルハンドルへ文字を出力する . 447 

_dos_fputs ファイルハンドルへ文字列を出力する . 448 

_dos_get_pr スレッドの管理情報を取得する . 449 

_dos_getc キーボードから 1 文字入力する . 451 

_dos_getchar 標準入力から 1 文字読み込む . 452 

-dos.getdate 現在の 日 付を取得す る . 453 

_dos_getdpb ドライブパラメータブロックを取得する . 454 

_dos_getenv 環境変数を取得す る . 456 

_dos_getfcb ファイルコントロールブロック （ FCB) を取得する …457 

_dos_getpdb 現在のプロセスのプロセス管理ボインタを求める ... 459 

_dos_gets 文字列を入力す る . 461 

_dos_getss 文字列を入力す る . 462 

_dos_gettim2 現在の時刻を取得する . 463 

_dos_gettime 現在の時刻を取得す る . 464 

_dos_hendsp 漢字変換行をコントロールする . 465 

_dos.importlnenv lndrv の管理情報への ポインタを返す . 467 

_dos_indosflg Human68k のワークフラグ IND 0 S—FLG のアドレスを 

取得する . 468 

_dos_inkey キーボードから 1 文字入力する . 469 

_dos_inpout コンソールの直接入出力を行う . 470 

_dos_intvcg 割り込みべクタを取得する . 471 

一 dos_intvcs 割り込みべクタを設定する . 472 

_dos_ioctrl デバイスドライバを直接制御する . 473 

_dos_keeppr プロセスを常駐終了させる . 476 

_dos_keyctrl CON デバイスの直接入力制御を行う . 477 

_dos_keysns キーの入力状態の検査を行う . 479 

_dos_kflush 入カバッファをフラッシュして，キーボード入力を 

行 ■? . 480 

_dos_kill_pr 自分自身のプロセスを削除する . 482 

_dos ユ f iles シンボリックリンクを処理せずにファイルを 

検索する . 483 











































_dos_link ハードリンクファイルを作成する . 485 

_dos_lock ファイルのロックを設定/解除する . 486 

_dos_maketmp 指定したパスにテンポラリファイルを作成する . 487 

_dos jnalloc メモリを確保する . 488 

_dosjnalloc2 メモリを指定した方法で確保する . 489 

_dosjnemcpy バス エラ ーが発生するかどうかをテストする . 490 

_dos_mfree メモリブロックを解放する . 491 

.dosjnkdir ディレクトリを作成する . 492 

_dos_move ファイルを移動する . 493 

_dos_nameck ファイル名を解析する . 494 

_dos_namests ファイル名を角¥析する . 495 

_dos_newfile ファイルを新規に作成する . 496 

_dos_nfiles _dos_files () で検索された次のファイルを 

検索する . 497 

_dos_open ファイルをオープンする . 498 

_dos_open_pr バックグラウンドプロセスを登録する . 499 

_dos.print 文字列を表示する . 501 

_dos_prnout プリンタに 1 文字出力する . 502 

_dos_prnsns プリンタへの出力が可能かどうかを調べる . 503 

_dos_pspset プロセス管理情報を設定する . 504 

_dos_putchar 標準出力へ 1 文字出力する . 506 

_dos_read ファイルからデータを読み込む . 507 

_dos_readlink シンボリックリンクのリンク先を調べる . 508 

一 dos_rename ファイル名を変更する . 509 

_dos_retshell コマンドシヱルにジャンプする . 510 

_dos_rmdir ディレクトリを削除する . 511 

_dos_s_malloc メインのメモリ管理下からメモリブロックを 

確保する . 512 

_dos_s_mfree メインのメモリ管理下のメモリブロックを解放する 513 

_dos_s_process サブのメモリ管理を設定する . 514 

_dos_seek ファイルポインタを移動する . 515 

_dos_send_pr 指定した スレッ ドに対して コマンド やデ ー タを送り， 

スレッドが SLEEP していたらスレッドを起こす .... 516 

_dos_setblock メモリブロックのサイズを変更する . 518 

_dos_setdate 現在の日付を設定する . 519 

_dos_setenv 環境変数を設定する . 520 

_dos_setpdb 管理プロセスを移す . 521 

_dos_settim2 現在の時刻を設定する . 522 

_dos_settime 現在の時刻を設定する . 523 

_dos_sleep_pr カレントスレッド SLEEP 状態にする . 524 












































Chapter 7 — Appendix A 


_dos_super スーハ 0 —ノくイザモードとユーザモードとを 

切り替える . 525 

_dos_super_jsr スーパーバイザ領域のプログラムをサブルーチン 

コールする . 526 

_dos_suspend_pr スレッドを強制的に SLEEP 状態にする . 527 

_dos_symlink シンボリックリンクファイルを作成する . 528 

_dos_time_pr 現在のタイマのカウンタ値を返す . 529 

_dos_unlink ハードリンクファイルを削除する . 530 

_dos_verify ベリファイフラグを設定する . 531 

.dos.verifyg ベリファイフラグの設定状況を取得する . 532 

_dos_vernum Human68k のバージョン番号を返す . 533 

_dos_wait 自プロセスが直前に実行した子プロセスの終了コード 

を返す . 534 

_dos_write フアイルへデータを書き込む . 535 
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ライブラリー第 2 部 



_iocs_abortjob アボート处理を行う . 538 

_iocs_abortrst アボートするために環境の再設定を行う . 539 

_iocs_adpcmain ADPCM からアレイチエインモードでデータを 

入力する . 540 

_iocs_adpcmaot ADPCM ヘアレイチ エイ ン モード で データを 

出力する . 541 

_iocs_adpcminp ADPCM からデータを入力する . 542 

_iocs_adpcmlin ADPCM からリンクアレイチエインモードでデータを 

入力する . 543 

_iocs_adpcmlot ADPCM ヘリンクアレイチエインモードでデータを 

出力する . 544 

_iocs_adpcmmod ADPCM の実行を制御する . 545 

_iocs_adpcmout ADPCM へデ ー タを出力する . 546 

_ iocs_adpcmsns ADPCM の実行モードを調べる . 547 

_iocs_akconv ANK コードからシフト JIS 漢字コードに変換する ..548 

_iocs_alarmget アラームの時間と処理アドレスを読み込む . 549 

_iocs_alarmmod アラームの 禁止/許可を設定する . 550 

-iocs_alarmset アラームの時間と処理アドレスの設定を行う . 551 

_iocs_apage グラフィック画面の書き込みページを設定する . 552 

_iocs_b_badfmt 不良トラックを登録する . 553 

_iocs_b_bpeek メモリから 1 バイトデータ読み込む . 554 

_iocs_b_bpoke メモリに 1 バイトデータ書き込む . 555 

_iocs_b_clr カーソル位置を基準としてテキスト画面を 

クリアする . 556 

_iocs_b_color 表示属性を設定する . 557 

_iocs_b_consol テキストの表示範囲を設定する . 558 

_iocs_b_curoff カーソルを消去す る . 559 

_iocs_b_curon カーソルを表示す る . 560 

_iocs_b_del カーソル表示行を削除する . 561 

_iocs_b_down カーソル位置を指定行数だけ下へ移動する . 562 

_iocs_b_down_s カーソル位置を 1 行下へ移動する . 563 

_iocs_b_drvchk フロッピーディスクドライブの状態の検査/設定を 

行つ . 564 

_iocs_b_drvsns ディスタのステータス情報を調べる . 566 









































. iocs . b.dskini ディスクインタフヱイスを初期化する . 567 

_ iocs _ b_eject ディスクのイジェクトを行う . 569 

_ iocs _ b_era カーソル位置を基準としてテキスト画面を 

クリアする . 570 

_ iocs _ b_format ディスクの物理フォーマットを行う . 571 

_ iocs _ b_ins カーソル表示行の直後に行を追加する . 572 

_ iocs _ b_intvcs 割り込みべクタを設定する . 573 

_ iocs _ b_keyinp キーコードの読み込みを行う . 574 

_ iocs_bJkeysns キーの先行入力の検査を行う . 575 

_ iocs _ b.left カーソル位置を指定桁数だけ左へ移動する . 576 

_ iocs _ b_locate カーソル位置を設定する . 577 

_ iocs _ b_lpeek メモリから1ロングワードデータ読み込む . 578 

_ iocs _ b_lpoke メモリに1ロングワードデータ書き込む . 579 

_ iocs _ b_memset メモリへデータを書き込む . 580 

_ iocs _ b_memstr メモリからデータを読み込む . 581 

_ iocs _ b_print 文字列を表示する . 582 

_ iocs _ b_putc 1文字表示する . 583 

_ iocs _ b_putmes 表示位置を指定して文字列を表示する . 584 

_ iocs _ b_read ディスクの読み込みを行う . 586 

_ iocs _ b_readdi フロッピーディスタの診断のための読み込みを行う 587 

_ iocs _ b_readdl フロ ッピーディスクの削除データを読み込む . 588 

_ iocs _ b_readid フロッピーディスクの ID データを読み込む . 589 

_ iocs _ b_recali トラック 0へ シークする . 590 

_ iocs _ b_right カーソル位置を指定桁数だけ右へ移動する . 591 

_ iocs _ b_seek 指定トラックまでシークする . 592 

_ iocs _ b_sftsns シフトキーの押下げ状態を検査する . 594 

_ iocs _ b_super スーパーバイザモードとユーザモードとを 

切り替える . 595 

_ iocs _ b_up カーソル位置を指定行数だけ上へ移動する . 596 

_ iocs _ b _ up_s 力ーソル位置を1行上へ移動する . 597 

_ iocs _ b_verify データの上匕較を行う . 598 

_ iocs _ b_wpeek メモリから1ワードデータ読み込む . 601 

_ iocs _ b_wpoke メモリに1ワードデータ書き込む . 602 

_ iocs _ b_write ディスクにデータを書き込む . 603 

_ iocs _ b_writed フロッピーディスクへ削除データを書き込む . 604 

_ iocs_bgctrlgt ノぐソクグラウンドコントロールレジスタを読み込む 605 

_ iocs_bgctrlst バックグラウンドコントロールレジスタを設定する 606 


_ iocs_bgscrlgt バックグラウンドスクロールレジスタを読み込む...607 

_ iocs_bgscrlst バックグラウンドスクロールレジスタを設定する ... 608 


_ iocs_bgtextcl バックグラウンドテキストをクリアする . 609 

_ iocs_bgtextgt バックグラウンドテキストを読み込む . 610 










































_ iocs_bgtextst バックグラウンドテキストを設定する . 611 

_ iocs_bindatebcd 2進数の日付を内部時計にセットできる形式に 

変換する . 612 

_ iocs_bindateget 内部時計から日付を読み込む . 613 

_ iocs_bindateset 内部時計に日付を設定する . 614 

_ iocs_bitsns 指定キーの押下げ状態を検査する . 615 

_ iocs_bootinf パワー ON 情報とシステムのブート情報を返す……616 

_ iocs_box グラフィック画面にボックスを描画する . 617 

_ iocs_circle グラフィック画面に円を描画する . 618 

_ iocs_clipput テキスト画面にパターンを書き出す 

(クリッビング処理つき） . 619 

_ iocs_contrast 画面のコントラストを設定する . 620 

. iocs.crtcras CRTC のラスタ割り込みを設定する . 621 

_ iocs_crtmod 画面モードを設定する . 622 

_ iocs_dakjob 濁点処理を行う . 624 

_ iocs_dateasc 日付を表す2進数形式のデータを文字列に変換する 625 

_ iocs_datebin 日付の形式を BCD から2進数に変換する . 626 

_ iocs_datecnv 日付を表す文字列を2進数形式に変換する . 627 

_ iocs_dayasc 曜日を表す2進数のデータを文字列に変換する . 628 

_ iocs_defchr 外字パターンを設定する . 629 

_ iocs_densns 電卓处理を行う . 630 

_ iocs_dmamode DMA の実行モードを調べる . 631 

_ iocs _ dmamov_a アレイチヱインモードで DMA 転送を行う . 632 

_ iocs _ dmamov_l リンクアレイチエインモードで DMA 転送を行う ... 633 

_ iocs_dmamove DMA 転送を行う . 634 

_ iocs_fill グラフィック画面に塗りつぶしたボックスを描画する635 

_ iocs_fntget 漢字パターンを取得する . 636 

_ iocs _ g _ clr_on グラフィック画面のクリア/表示を行う . 637 

_ iocs_getgrm グラフィック画面からデータを読み込む . 638 

_ iocs_gpalet グラフィックパレットを設定する . 639 

_iocs 上 anjob 半濁点处理を行う . 640 

_iocs 上 ome グラフィック画面の表示開始位置を設定する . 641 

_ iocs_hsvtorgb HSV 方式から RGB 方式への色変換を行う . 642 

. iocs_hsyncst H-SYNC (水平同期信号）割り込みを設定する . 643 

_ iocs _ init_prn プリンタポートの初期化を行う . 644 

_ iocs _ inp 232 c RS -232 C の受信バッファから1バイトデータ 

読み込む . 645 

_ iocs_iplerr IPL エラー時の处理を行う . 646 

_ iocs _ isns 232 c RS -232 C の受信バッファ内にデータがあるかどうかを 

調べる . 647 








































_ iocs_jissft JIS 漢字コードからシフト JIS 漢字コードに 

変換する . 648 

_ iocs_joyget ジョイスティックのデータを取得する . 649 

•iocsJLedmod LED つきキーの設定を行う . 650 

_ iocs_line グラフィック画面にラインを描画する . 651 

_ iocs _ lof 232 c RS -232 C の受信バッファ内のデータ数を調べる.…652 

_ iocs _ ms_curgt マウスカーソルの座標を調べる . 653 

_ iocs _ ms_curof マウスカーソルを消去する . 654 

_ iocsjns_curon マウスカーソルを表示する . 655 

_ iocs _ ms_curst マウスカーソルの座標を設定する . 656 

_ iocs _ ms_getdt マウスの移動量とボタンの状態を調べる . 657 

_ iocs _ ms_init マウスを初期化する . 658 

_ iocs _ ms_limit マウスカーソルの移動範囲を設定する . 659 

_ iocs _ ms_offtm マウスボタンを離すまでの時間を調べる . 660 

_ iocs _ ms_ontm マウスボタンを押すまでの時間を調べる . 661 

_ iocs _ ms_patst マウスカーソルのパターンを定義する . 662 

_ iocs _ ms_sel マウスカーソルを選択する . 663 

_ iocs _ ms _ sel 2 マウスカーソルを複数選択し，アニメーションを 

作成する . 664 

_ iocs _ ms_stat マウスカーソルの表示モードを調べる . 665 

_ iocs_ontime 電源投入またはリセットしてからの経過時間を 

調べる . 666 

_ iocs_opmintst FM 音源 IC ( YM 2151) による割り込みを設定する…667 

_ iocs_opmset FM 音源 ( YM 2151) にデータを書き込む . 668 

_ iocs_opmsns FM 音源 （ YM 215 1) の ステータスを 読む . 669 

_ iocs _ os_curof カーソルを消去する . 670 

_ iocs _ os_curon カーソルを表示する . 671 

_ iocs _ osns 232 c RS -232 C が送信可能かどうかを調べる . 672 

_ iocs _ out 232 c RS -232 C へ1バイト送信する . 673 

_ iocs_outlpt プリンタへの直接出力を行う . 674 

_ iocs_outprn プリンタにデータを出力する . 675 

_ iocs_paint グラフィック画面のペイントを行う . 676 

_ iocs-point グラフィック画面の指定座標のパレットコードを 

調べる . 677 

_ iocs_prnintst プリンタ割り込みを設定する . 678 

_ iocs_pset グラフィック画面に点を描画する . 679 

_ iocs_putgrm グラフィック画面にデータを書き込む . 680 

_ iocs_rmacnv ローマ字/かな変換を行う . 681 

_ iocs_romver ROM のバージョンと作成日付を調べる . 682 

_ iocs_scroll テキスト/グラフィックの表示開始座標を設定する ...683 

_ iocs _ set 232 c RS -232 C の通信モードを設定する . 684 











































_ iocs_sftjis シフト JIS 漢字コードから JIS 漢字コードに 

変換する . 686 

_ iocs _ skey_mod ソフトキーボードを制御する . 687 

_ iocs_skeyset 指定したキーが押されたことにする . 688 

- iocs.snsprn プリンタ出力が可能かどうかを調べる . 689 

_ iocs _ sp_cgclr PCG をクリアする . 690 

_ iocs _ sp_def eg PCG を設定する . 691 

_ iocs _ sp_gtpcg PCG を読み込む . 692 

_ iocs _ sp_init スプライト画面を初期化する . 693 

_ iocs _ sp_off スプライト画面を非表示にする . 694 

_ iocs _ sp_on スプライト画面を表示する . 695 

_ iocs _ sp_reggt スプライトレジスタを読み込む . 696 

_ iocs _ sp_regst スプライトレジスタを設定する . 697 

_ iocs_spalet スプライトパレットの設定/読み込みを行う . 698 

_ iocs_symbol グラフィック画面に文字を描画する . 699 

_ iocs_tcolor テキストのカラーを選択する . 701 

_ iocs_textget テキスト画面からデータを読み込む . 702 

_ iocs_textput テキスト画面にデータを書き込む . 703 

_ iocs_tgusemd 画面モードを設定/取得する . 704 

_ iocs_timeasc 時刻を表す2進数形式のデータを文字列に変換する 705 

_ iocs_timebcd 2進数の時刻を内部時計にセットできる形式に 

変換する . 706 

. iocs_timebin 時刻を BCD 形式から2進数形式へ変換する . 707 

_ iocs_timecnv 時刻を表す文字列を2進数形式に変換する . 708 

_ iocs_timeget 内部時計から時刻を読み込む . 709 

_ iocs_timerdst MFP の TIMER - D による割り込みを設定する . 710 

_ iocs_timeset 内部時計に時刻を設定する . 711 

_ iocs_tpalet テキストパレットを設定する . 712 

_ iocs _ tpalet 2 テキストパレットを設定する . 713 

_ iocs _ trapl 5 内部割り込み (trap #15) を直接実行する . 714 

_ iocs_tvctrl 専用テレビを操作する . 715 

- iocs.txbox テキスト画面にボックスを描画する . 717 

_ iocs_txfill テキスト画面に塗りつぶしたボックスを描画する ... 718 

_ iocs_txrascpy テキスト画面のラスタコピーを行う . 719 

_ iocs_txrev テキスト画面を反転する . 720 

_ iocs_txxline テキスト画面に水平方向のラインを描画する . 721 

_ iocs_txyline テキスト画面に垂直方向のラインを描画する . 722 

_ iocs_vdispst 垂直同期による割り込みを設定する . 723 

_ iocs_vpage グラフィック画面の表示ページを設定する . 724 

- iocs.window グラフィック画面のウィンドウを設定する . 725 

_ iocs_wipe グラフィック画面を消去する . 726 















































Chapter 7 — Appendix A 



ismbbalnum 半角英数字/半角カタカナかどうかを調べる . 728 

ismbbalpha 半角英字/半角カタカナかどうかを調べる . ，729 

ismbbgraph 半角スペース以外の表示可能文字かどうかを調べる . 730 

ismbbkalnum 半角カタカナかどうかを調べる . 731 

ismbbkana 半角カナ文字かどうかを調べる . 732 

ismbbkpunct 半角カナ記号かどうかを調べる . 733 

ismbblead 全角文字の第1バイトかどうかを調べる . 734 

ismbbprint 半角印字可能文字かどうかを調べる . 735 

ismbbpunct 半角記号/半角カナ記号かどうかを調べる . 736 

ismbbtrail 全角文字の第2バイトかどうかを調べる . 737 

ismbcalpha 全角英字かどうかを調べる . 738 

ismbcdigit 全角数字かどうかを調べる . 739 

ismbchira 全角ひらがなかどうかを調べる . 740 

ismbckata 全角カタカナかどうかを調べる . 741 

ismbclO JIS 非漢字かどうかを調べる . 742 

ismbcll JIS 第1水準漢字かどうかを調べる . 743 

ismbcl 2 JIS 第2水準漢字かどうかを調べる . 744 

ismbclegal 正しいシフト JIS 全角文字かどうかを調べる . 745 

ismbclower 全角英小文字かどうかを調べる . 746 

ismbcprint 印字可能文字かどうかを調べる . 747 

ismbcspace 全角スぺースかどうかを調べる . 748 

ismbc symbol 全角記号かどうかを調べる . 749 

ismbcupper 全角英大文字かどうかを調べる . 750 

mbbtombc 半角文字を全角文字に変換する . 751 

mbbtype バイトデータの文字種を判別する . 752 

mbctohira 全角カタカナを全角ひらがなに変換する . 753 

mbctokata 全角ひらがなを全角カタカナに変換する . 754 

mbctolower 全角英大文字を全角英小文字に変換する . 755 

mbctombb 全角文字を半角文字に変換する . 756 

mbctoupper 全角英小文字を全角英大文字に変換する . 757 

mblen 1マルチバイト文字の構成バイト数を調べる . 209 

mbsbtype 文字列中の指定位置の文字種を判別する . 758 

mbscat シフト JIS 文字列を他のシフト JIS 文字列に連結する •. • 759 

mbschr シフト JIS 文字列中から指定文字を検索する . 760 
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mbscmp 2 つのシフト JIS 文字列を比較する . 761 

mbscpy シフト JIS 文字列をコピーする . 762 

mbscspn 指定したシフト JIS 文字列に含まれない文字が，ほかの 

シフト JIS 文字列の先頭から何文字続いているかを調べる 
. 763 

mbsdec シフト JIS 文字列のボインタを1文字分戻す . 764 

mbsdup 新しい領域を確保してシフト JIS 文字列をコピーする•••765 

mbsicmp 2つのシフト JIS 文字列を大文字/小文字を区別せずに 

比較する . 766 

mbsinc シフト JIS 文字列のボインタを1文字分進める . 767 

mbslen シフト JIS 文字列の長さを調べる . 768 

mbslwr シフト JIS 文字列を小文字に変換する . 769 

mbsnbcnt シフト JIS 文字列のバイト数を調べる . 770 

mbsncat シフト JIS 文字列を指定文字数だけほかのシフト JIS 

文字列に追加する . 771 

mbsnccnt シフト JIS 文字列の文字数を調べる . 772 

mbsncmp 2つのシフト JIS 文字列を指定文字数だけ比較する……773 

mbsncpy シフト JIS 文字列を指定文字数だけコピーする . 774 

mbsnextc ポインタが指す位置文字を返す . 775 

mbsninc シフト JIS 文字列のポインタを指定文字分だけ進める. •• 776 

mbsnset シフト JIS 文字列を指定文字で指定文字数だけ埋める ... 777 

mbspbrk 指定したシフト JIS 文字列に含まれる文字が， 

ほかのシフト JIS 文字列に存在するかどうかを調べる • • • 778 


mbsrchr シフト JIS 文字列中から指定文字が最後に現れる位置を 


検索する . 779 

mbsrev シフト JIS 文字列を前後反転させる . 780 

mbsset シフト JIS 文字列を指定文字で埋める . 781 


mbsspn 指定したシフト JIS 文字列に含まれる文字が，ほかの 

シフト JIS 文字列の先頭から何文字続いているかを調べる 

. 782 

mbsstr 指定したシフト JIS 文字列がほかのシフト JIS 文字列に 


存在するかどうかを調べる . 783 

mbstok シフト JIS 文字列を指定した区切り文字でトークンに 

分ける . 784 

mbstowcs マルチ バイ ト文字列を幅広文字列に変換する . 210 

mbsupr シフト JIS 文字列を大文字に変換する . 785 

mbtowc マルチ バイ ト文字を幅広文字に変換する . 211 
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SCSI コ 


_scsi_cmdout コマンドアウトフヱー ズを実行する . 788 

_scsi_datain データイ ンフヱ ーズを 実行する . 789 

_scsi_datain_p データインフェーズを実行する . 790 

_scsi_dataout データアウトフェーズを実行する . 791 

_scsi_dataout_p データアウトフェーズを実行する . 792 

_scsi_format SCSI ユニットを物理フォーマットする . 793 

_scsi.inquiry INQUIRY データを要求する . 794 

_scsi_modeselect SCSI ユニットにモードセレクトコマンドを発行する 795 

_scsi_modesense SCSI ユニットの 各種パラメータを調べる . 796 

_scsi_msgin メッセージインフヱーズを実行する . 797 

_scsi_msgout メッセージアウトフヱーズを実行する . 798 

_scsi_pamedium SCSI ユニットにメディアのイジェクトの禁止/許可を 

設定する . 799 

_scsi.phase SCSI フェーズセンスを実行する . 800 

_scsi_read SCSI ユニット のデータを読み込む . 801 

_scsi_readcap SCSI ユニットの容量に関する情報を読み込む . 802 

_scsi_readext 披張 READ コマンドで SCSI ユニットのデータを 

読み込む . 803 

_scsi_reassign SCSI ユニットの欠陥ブロックの再割り当てを行う .. 804 

_scsijrequest SCSI ユニッ トのセンスデータを調べる . 805 

_scsi_reset SPC のリセットおよび SCSI バスのリセットを行う • 806 

_scsi_rezerounit SCSI ユニットを指定の状態にセットする . 807 

_scsi_seek SCSI ユニットを指定の論理ブロックにシークする •• 808 

_scsi_select アービトレーシヨンフェーズとセレクシヨンフェーズを 

実行する . 809 

_scsi_startstop SCSI ユニットに対して，以降の操作を可能または 

不可能にする . 810 

_scsi_stsin ステータス イン フェーズを実行す る . 811 

_scsi_testunit SCSI ユニットが動作可能かどうかを調べる . 812 

_scsi .write SCSI ユニットにデータを書き込む . 813 

_scsi_writeext 拡張 WRITE コマンドで SCSI ユニット に データを 

書き込む . 814 

































ライブラリー第 2 部 



fgetwc ファイルストリームから 1 幅広文字を取り出す . 816 

fgetws ファイルストリームから幅広文字列を取り出す . 817 

fputwc ファイルストリームに幅広文字を出力する . 818 

fputws ファイルストリームに幅広文字列を出力する . 819 

getwc ファイルストリームから 1 幅広文字を取り出す . 820 

getwchar 標準入カファイルストリームから1幅広文字を 

取り出す . 821 

getws 標準入カファイルストリームから幅広文字列を 

取り出す . 822 

iswalnum 英数字かどうかを調べる . 823 

iswalpha アルファベットかどうかを調べる . 824 

iswascii 7 ビット ASCII 文字かどうかを調べる . 825 

iswcntrl 制御文字かどうかを調べる . 826 

iswdigit 数字かどうかを調べる . 827 

iswgraph 表示可能文字かどうかを調べる . 828 

iswlower 英小文字かどうかを調べる . 829 

iswprint 英大文字かどうかを調べる . 830 

iswpunct 記号文字かどうかを調べる . 831 

iswspace 空白文字かどうかを調べる . 832 

iswupper 英大文字かどうかを調べる . 833 

iswxdigit 16 進数字かどうかを調べる . 834 

putwc ファイルストリームに幅広文字を出力する . 835 

putwchar 標準出カファイルストリームに幅広文字を出力する 836 

putws 標準出カファイルストリームに幅広文字列を出力する ...837 

towlower 大文字を小文字に変換する . 838 

towupper 小文字を大文字に変換する . 839 

ungetwc 入カファイルストリームに幅広文字を押し戻す . 840 

wcscat 文字列をほかの文字列に連結する . 841 

wcschr 文字列中から指定文字を検索する . 842 

wcscmp 2 つの文字列を比較する . 843 

wcscoll 2つの幅広文字列をロケールを用いて比較する . 844 

wcscpy 文字列をコピーする . 845 

wcscspn 指定文字列に含まれない文字が，ほかの文字列の 

先頭から何文字続いているかを調べる 


886 


846 









































wcsdup 新しい領域を確保して文字列を コピーす る . 847 

wcslen 文字列の長さを調べる . 848 

wcsncat 文字列を指定文字数だけほかの文字列に追加する . 849 

wcsncmp 2 つの文字列を指定文字数だけ比較する . 850 

wcsncpy 文字列を指定文字数だけ コピーす る . 851 

wcspbrk 指定文字列に含まれる文字がほかの文字列に存在するか 

どうかを調べる . 852 

wcsrchr 文字列中から指定文字が最後に現れる位置を検索する ... 853 

wcsspn 指定文字列に含まれる文字が，ほかの文字列の先頭から 

何文字続いているかを調べる . 854 

wcstod 幅広文字列を double 型倍精度浮動小数に変換する . 855 

wcstok 文字列を指定した区切り文字でトークンに分ける . 856 

wcstol 幅広文字列を long 型整数に変換する . 857 

wcstombs 幅広文字列をマルチバイト文字列に変換する . 394 

wcstoul 幅広文字列を皿 signed long 型整数に変換する . 858 

wcswcs 指定文字列がほかの文字列に存在するかどうかを 

調べる . 859 

wcsxfnn 2 つの幅広文字列をロケールを用いて指定の 

幅広文字数だけコピーする . 860 

wctomb 幅広文字をマルチバイト文字に変換する . 395 
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I Symbols! 

2進数形式……612, 625-628, 705-708 

8進数字 . 184 

8ビット ISO 文字 . 181 

8ビット ISO 文字コード . 368 

16進数字 . 189, 834 
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abort () . 5,15,19, 225, 290 

abs (). 6 

accessO .7 

acos () . 8 

acoshO .9 

_addlastsep() . 4 

ADPCM . 540-547 

alaxmO .10 

allocaO .11 
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__ALLOCA_STACK_CHECK_..11 

ANK コード .548 
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asinhO .14 

assert().15 
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atan().16 

atan2().17 
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chmodO . 
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chown(). 
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chsizeO . 
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_circleptr 構造体 
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clearenvO . 
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clearerr(). 
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_clipxy 構造体… 
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clockO . 
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closedir () . 

•comline 構造体 . 

commit (). 

.41 

.433 

common V 只楓 . 


cos (). 

.43 

cosh (). 

.44 

cprintf () . 

.45 

CPU 消费時間 . 

.158, 275 

CPU タイプ . 

.262 

cputsO . 

.46 

creat () . 

■••• 47, 376, 380 

ctermidO . 

.48 

ctimeO . 

■ 12, 49,162, 196 

cuseridO . 

.50 


2 

daylight . 373 

_dehupair ().51 

_dellastsep() . 52 

difftimeO .53 


__DIRECTJFLOAT__.8, 9, 13, 14, 

16-18, 43, 44, 77, 82, 102, 193, 198, 
199, 222, 295, 297, 311 ， 358, 360 

__DIRECT_FPU__ .8, 9,13,14, 

16-18, 43, 44, 77, 82,102, 193,198, 
199, 222, 295, 297, 311, 358, 360 

一 DIRECT—IOFPU—. 8, 9,13,14, 

16-18, 43, 44, 77, 82, 102, 193,198, 
199, 222, 295, 297, 311, 358, 360 

dirent 構造体 .251 

div().54 

div_t 構造体 .54 


DMA .599, 631-634 

DMA 転送 . 789, 791 

DOS ファイルアトリビュート 


. 205, 206 

_dos_allclose() . 398 

_dos_bindno() . 434, 435 

_dos_breakck() .401 

_dos_c_cls_al().413 

_dos_c_cls_ed() . 413 

_dos_c_cls_st() .413 

_dos_c_color ().412 

_dos_c_curoff U .414 

_dos_c_curon().414 

_dos_c_del(). 414 

_dos_c_down(). 413 


_dos_c_down_s(). 413 

_dos_c_era_al(). 414 

_dos_c_era_ed(). 413 

_dos_c_era_st (). 414 

_dos_c_fnkmod() . 414 

_dos_c_ins() . 414 

_dos_cJLeft (). 413 

_dos_c_locate() .413 

_dos_c_print(). 412 

_dos_c_putc(). 412 

_dos_c_right(). 413 

_dos_c_up() . 413 

_dos_c_up_s() . 413 

_dos_c_width(). 414, 415 

_dos_c.window () .414 

_do s .change _pr ( ) .402 

_dos_chdir().403 

_dos_chgdrv() .404 

_dos_chmod().405 

_dos_cinsns() .406 

_dos_close(). 407, 430 

_dos_cominp() . 401, 408 

_dos_common_ck ( ) . 409, 410 

_dos_common_del().409 

_dos_common_fre () .409 

_dos_common_lk() .409 

_dos_common_rd() . 410 

_dos_common_wt () . 410 

_dos_comout () . 401，411 

_dos_consns() .416 

_dos_coutsns() .417 

_dos_create() . 418, 487, 496 

_dos_ctlabort() .419 

_dos_curdir () .420 

_dos_curdrv() . 421 

_dos_delete() .422 

_dos_diskred() . 423, 438, 439 

_dos_diskred2() . 423, 438, 439 

_dos_diskwrt() . 424 

_do s _di skwr12 ( ) .424 

_dos_drvctrl().425 

_dos_drvxchg() .427 

一 do s _dskfre() .428 

_dos_dup() . 429, 430 

_do s _dup0() .430 

_dos_dup2() . 430, 431 

_do s _errabort() .432 





























































































_dos_exec2() 
_dos_execonly() 

_dos_exit() - 

_dos_exit2() — 
_dos_f atchkO • 
_dos_f atchk2() 



. 434, 435 

. 434, 435 

•…436, 482, 512 
436, 437, 482, 512 

. 438, 439 

. 438, 439 

.440 


_dos_fgetc() . 441 

_dos_fgets() . 442 

_dos_filedateO . 443 


_dos.files(). 444, 483, 497 

—dos—fnckeygt () .446 

_dos_fnckeyst () . 446 

_dos_fput () .401 

_dos_fputc(). 401, 447, 448 

_dos_fputs().448 

_dos_get_pr() .449 

_dos_getassign(). 399, 400 

_dos_getc(). 401, 451, 469, 480 

_dos_getchar() . 401, 452, 480 

_dos_getdate() . 453 

_dos_getdpb() .454 

_dos_getenv() .456 

_dos_getfcb() . 457, 458 

_dos_getpdb() . 459, 521 

_dos_gets() . 401, 461， 480 

_dos_getss().462 

_dos_gettim2() .463 


_dos_gettime() .464 

_dos_hendspic() . 465, 466 

_dos Jiendspio () . 465, 466 

_dos_hendspip() . 465, 466 

一 dos 上 endspir () . 465, 466 

_dos-hendspmc () . 465, 466 

_dos 上 endspmoO . 465, 466 

_dos_hendspmp () . 465, 466 

_dos_hendspmr() . 465, 466 

_dos 上 endspscO . 465, 466 

_dos Jiendspso () . 465, 466 

_dos_hendspsp () . 465, 466 

_dos Jiendspsr () . 465, 466 

_D0S_IEXEC. 205, 206 

-DOS.IFDIR. 205, 206 

_D0S_IFLNK. 205, 206 

_D0S_IFREG . 205, 206 

_D0S_IFV0L . 205, 206 

_D0S_IHIDDEN. 205, 206 


_dos .import lnenv () . 467 

-dos-indosflg() . 468 

_dos_inkey(). 469, 480 

_dos_inpout () . 470,481 

_dos_intvcg() . 471 

_dos_intvcs() . 472, 490, 526 

_dos_ioctrldvctl(). 474,475 

_dos_ioctrldvgt (). 474, 475 

_dos_ioctrlfdctl(). 474,475 

_dos_ioctrlfdgt (). 474, 475 

_dos_ioctrlgt() . 473,474 

_dos_ioctrlis() . 474,475 

_dos-ioctrlos() . 474,475 

_dos_ioctrlrd() . 473, 475 

_dos_ioctrlrh() . 473, 475 

_dos_ioctrlrtset () . 474, 475 

_dos_ioctrlst () . 473,475 

_dos_ioctrlwd() . 474, 475 

_dos_ioctrlwh() . 473, 475 

_D0S_IRD0NLY. 205, 206 

_D0S_ISYS . 205, 206 

_dos_k_insmod() . 477, 478 

_dos_k_keybit () .478 

_dos_k_keyinp() . 477, 478 

_dos_k_keysns() . 477,478 

_dos_k_sftsns() . 477, 478 

_dos_keeppr() . 476, 499 

_dos_keysns() . 401, 479 

_dos_kf lush() .481 

_dos_kflushgc ( ) . 480, 481 

_dos_kflushgp() . 480, 481 

_dos_kflushgs() . 480, 481 

_dos_kf lushinO . 480, 481 

_dos_kf lushioO . 480, 481 

_dos_kill_pr (). 482, 499 

_dos ユ filesO . 483, 484 

_dos_link() .485 

_dos_load() . 433-435 

_dos_loadexec() . 433-435 

_dos_loadonly() . 434, 435 

_dos_lock() .486 

_dos_makeassign(). 399, 400 

_do s _maketmp() .487 

_dosjnalloc() ... 488, 491, 505, 518 

_dos_malloc2() . 489, 491， 518 

_dos_memcpy () .490 

_dos_mf ree().491 


































































































_dosjnkdir(). 492 

_dos_move() . 493 

_dos_nameck() . 494 

_dos_aamests() . 495 

_dos_newfile() . 496 

_ dos_nfilesO ■•- 444, 445, 484, 497 

_dos_open() . 498 

_dos_open_pr (). 499 

_dos_pathchk() . 434, 435 

_dos_print (). 401, 501 

_dos_prnout() . 401, 502 

_dos_prnsns() .503 

_dos_pspset() . 504 

_dos_putchar () . 401 , 506 

_dos_rassign() . 399, 400 

_dos_read() .507 

_dos_readlink() .508 

_dos_rename() . 493, 509 

_dos_retshell().510 

_dos_rmdir().ail 

_dos_s_malloc() . 512, 513 

_dos_s_mfree().513 

_dos_s_process () . 513, 514 

_dos_seek() . 515 

_dos_send_pr () 

. 516, 517, 524, 527 

_dos_setblock() . 518 

_dos_setdate() .519 

_dos_setenv() . 520 

_dos_setpdb() . 521 

_dos_settim2() .522 

_dos_settime() .523 

_dos_sleep_pr() . 524 

_dos_super() . 525 

_dos_super_j sr () .526 

_dos_suspend_pr () . 524, 527 

_dos_symlink() .528 

_dos_time_pr ().529 

一 do s _unlink () . 485, 530 

_dos_verify() . 531 

_dos_verifyg() .532 

_dos_vernum() .533 

_dos_wait () .534 

_dos_write().535 

double 型 

.20, 55, 110, 120, 343, 855 

double * 型 .120 


_dpbptr 構造体 . 454 

drandO . 55 

dup(). 56 

dup2() . 57, 87 
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ecvt 0 . 61， 88 

EDOM. 295, 297, 311，358, 360 

_enargv(). 11， 58 

endgrentO •- 62,143, 145, 146, 270 
endpwentO •- 63,154, 156, 157, 274 

EN0ENT . 234 

environ 

37, 64, 67, 72, 241， 301, 306, 434 
EOF.65, 85, 


86, 93, 95，101， 111-113, 121，132, 
134，148，149，161， 172-174, 176- 
179，181， 182， 184-189， 236， 238, 
240, 242, 266, 310, 314, 378, 388, 
390, 392, 728-737, 819, 837, 840 

eprintf() . 65 

ERANGE … . 43, 44, 77,193, 198, 199, 
295, 297, 358 

_errcnv() . 60 

errno.7-9,13,14,16-19, 

25, 28, 29, 31, 32, 34-38, 40, 42-44, 
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